--- title: Permission Groups --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [IAM](https://developers.cloudflare.com/api/python/resources/iam) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Permission Groups ##### [List Account Permission Groups](https://developers.cloudflare.com/api/python/resources/iam/subresources/permission_groups/methods/list) iam.permission\_groups.list(PermissionGroupListParams\*\*kwargs) -> SyncV4PagePaginationArray\[[PermissionGroupListResponse]()] GET/accounts/{account\_id}/iam/permission\_groups ##### [Permission Group Details](https://developers.cloudflare.com/api/python/resources/iam/subresources/permission_groups/methods/get) iam.permission\_groups.get(strpermission\_group\_id, PermissionGroupGetParams\*\*kwargs) -> [PermissionGroupGetResponse]() GET/accounts/{account\_id}/iam/permission\_groups/{permission\_group\_id} ##### ModelsExpand Collapse
class PermissionGroupListResponse: … A named group of permissions that map to a group of operations against resources. id: str Identifier of the permission group. Link to this property
meta: Optional\[Meta] Attributes associated to the permission group. category: Optional\[str] A category used to group permission groups. Link to this property deprecated: Optional\[str] Indicates whether the permission group is deprecated. Link to this property description: Optional\[str] Additional information about the permission group. Link to this property editable: Optional\[str] Indicates whether the permission group can be edited. Link to this property eol\_at: Optional\[datetime] The planned end-of-life date and time, when provided. formatdate-time Link to this property label: Optional\[str] A label identifying the permission group. Link to this property scopes: Optional\[str] The scope associated with the permission group. Link to this property visibility: Optional\[str] Indicates the permission group’s availability or visibility. Link to this property
Link to this property name: Optional\[str] Name of the permission group. Link to this property
[Link to this property](<#(resource)%20iam.permission_groups%20%3E%20(model)%20permission_group_list_response%20%3E%20(schema)>)
class PermissionGroupGetResponse: … A named group of permissions that map to a group of operations against resources. id: str Identifier of the permission group. Link to this property
meta: Optional\[Meta] Attributes associated to the permission group. category: Optional\[str] A category used to group permission groups. Link to this property deprecated: Optional\[str] Indicates whether the permission group is deprecated. Link to this property description: Optional\[str] Additional information about the permission group. Link to this property editable: Optional\[str] Indicates whether the permission group can be edited. Link to this property eol\_at: Optional\[datetime] The planned end-of-life date and time, when provided. formatdate-time Link to this property label: Optional\[str] A label identifying the permission group. Link to this property scopes: Optional\[str] The scope associated with the permission group. Link to this property visibility: Optional\[str] Indicates the permission group’s availability or visibility. Link to this property
Link to this property name: Optional\[str] Name of the permission group. Link to this property
[Link to this property](<#(resource)%20iam.permission_groups%20%3E%20(model)%20permission_group_get_response%20%3E%20(schema)>)