--- title: List Memberships --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [Memberships](https://developers.cloudflare.com/api/python/resources/memberships) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # List Memberships memberships.list(MembershipListParams\*\*kwargs) -> SyncV4PagePaginationArray\[[Membership]()] GET/memberships List memberships of accounts the user can access. ##### Security API Email + API Key The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key. **Example:**`X-Auth-Email: user@example.com` The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys. **Example:**`X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194` ##### Accepted Permissions (at least one required) `Memberships Write``Memberships Read` ##### ParametersExpand Collapse
account: Optional\[Account] name: Optional\[str] Account name maxLength100 Link to this property
[Link to this property](<#(resource)%20memberships%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20account%20%3E%20(schema)>)
direction: Optional\[Literal\["asc", "desc"]] Direction to order memberships. One of the following: "asc" Link to this property "desc" Link to this property
[Link to this property](<#(resource)%20memberships%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20direction%20%3E%20(schema)>) name: Optional\[str] Account name maxLength100 [Link to this property](<#(resource)%20memberships%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20name%20%3E%20(schema)>)
order: Optional\[Literal\["id", "account.name", "status"]] Field to order memberships by. One of the following: "id" Link to this property "account.name" Link to this property "status" Link to this property
[Link to this property](<#(resource)%20memberships%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20order%20%3E%20(schema)>) page: Optional\[float] Page number of paginated results. minimum1 [Link to this property](<#(resource)%20memberships%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20page%20%3E%20(schema)>) per\_page: Optional\[float] Number of memberships per page. maximum50 minimum5 [Link to this property](<#(resource)%20memberships%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20per_page%20%3E%20(schema)>)
status: Optional\[Literal\["accepted", "pending", "rejected"]] Status of this membership. One of the following: "accepted" Link to this property "pending" Link to this property "rejected" Link to this property
[Link to this property](<#(resource)%20memberships%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20status%20%3E%20(schema)>) ##### ReturnsExpand Collapse
class Membership: … id: Optional\[str] Membership identifier tag. maxLength32 Link to this property
account: Optional\[Account] id: str Identifier maxLength32 minLength32 Link to this property name: str Account name maxLength100 Link to this property
type: Literal\["standard", "enterprise"] One of the following: "standard" Link to this property "enterprise" Link to this property
Link to this property created\_on: Optional\[datetime] Timestamp for the creation of the account formatdate-time Link to this property
managed\_by: Optional\[ManagedBy] Parent container details parent\_org\_id: Optional\[str] ID of the parent Organization, if one exists maxLength32 Link to this property parent\_org\_name: Optional\[str] Name of the parent Organization, if one exists Link to this property
Link to this property
settings: Optional\[Settings] Account settings abuse\_contact\_email: Optional\[str] Sets an abuse contact email to notify for abuse reports. Link to this property enforce\_twofactor: Optional\[bool] Indicates whether membership in this account requires that Two-Factor Authentication is enabled Link to this property
Link to this property
Link to this property api\_access\_enabled: Optional\[bool] Enterprise only. Indicates whether or not API access is enabled specifically for this user on a given account. Link to this property
permissions: Optional\[Permissions] All access permissions for the user at the account.
analytics: Optional\[PermissionGrant] read: Optional\[bool] Link to this property write: Optional\[bool] Link to this property
Link to this property
billing: Optional\[PermissionGrant] read: Optional\[bool] Link to this property write: Optional\[bool] Link to this property
Link to this property
cache\_purge: Optional\[PermissionGrant] read: Optional\[bool] Link to this property write: Optional\[bool] Link to this property
Link to this property
dns: Optional\[PermissionGrant] read: Optional\[bool] Link to this property write: Optional\[bool] Link to this property
Link to this property
dns\_records: Optional\[PermissionGrant] read: Optional\[bool] Link to this property write: Optional\[bool] Link to this property
Link to this property
lb: Optional\[PermissionGrant] read: Optional\[bool] Link to this property write: Optional\[bool] Link to this property
Link to this property
logs: Optional\[PermissionGrant] read: Optional\[bool] Link to this property write: Optional\[bool] Link to this property
Link to this property
organization: Optional\[PermissionGrant] read: Optional\[bool] Link to this property write: Optional\[bool] Link to this property
Link to this property
ssl: Optional\[PermissionGrant] read: Optional\[bool] Link to this property write: Optional\[bool] Link to this property
Link to this property
waf: Optional\[PermissionGrant] read: Optional\[bool] Link to this property write: Optional\[bool] Link to this property
Link to this property
zone\_settings: Optional\[PermissionGrant] read: Optional\[bool] Link to this property write: Optional\[bool] Link to this property
Link to this property
zones: Optional\[PermissionGrant] read: Optional\[bool] Link to this property write: Optional\[bool] Link to this property
Link to this property
Link to this property roles: Optional\[List\[str]] List of role names the membership has for this account. Link to this property
status: Optional\[Literal\["accepted", "pending", "rejected"]] Status of this membership. One of the following: "accepted" Link to this property "pending" Link to this property "rejected" Link to this property
Link to this property
[Link to this property](<#(resource)%20memberships%20%3E%20(model)%20membership%20%3E%20(schema)>) ### List Memberships Python HTTPTypeScriptPythonGoTerraform ``` import os from cloudflare import Cloudflare client = Cloudflare( api_email=os.environ.get("CLOUDFLARE_EMAIL"), # This is the default and can be omitted api_key=os.environ.get("CLOUDFLARE_API_KEY"), # This is the default and can be omitted ) page = client.memberships.list() page = page.result[0] print(page.id) ``` 200 example ``` { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "success": true, "result": [ { "id": "4536bcfad5faccb111b47003c79917fa", "account": { "id": "023e105f4ecef8ad9ca31a8372d0c353", "name": "Demo Account", "type": "standard", "created_on": "2014-03-01T12:21:02Z", "managed_by": { "parent_org_id": "4536bcfad5faccb111b47003c79917fa", "parent_org_name": "Demo Parent Organization" }, "settings": { "abuse_contact_email": "abuse_contact_email", "enforce_twofactor": true } }, "api_access_enabled": true, "permissions": { "analytics": { "read": true, "write": false }, "billing": { "read": true, "write": false }, "cache_purge": { "read": true, "write": false }, "dns": { "read": true, "write": false }, "dns_records": { "read": true, "write": false }, "lb": { "read": true, "write": false }, "logs": { "read": true, "write": false }, "organization": { "read": true, "write": false }, "ssl": { "read": true, "write": false }, "waf": { "read": true, "write": false }, "zone_settings": { "read": true, "write": false }, "zones": { "read": true, "write": true } }, "roles": [ "Account Administrator" ], "status": "accepted" } ], "result_info": { "count": 1, "page": 1, "per_page": 20, "total_count": 2000 } } ``` ##### Returns Examples 200 example ``` { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "success": true, "result": [ { "id": "4536bcfad5faccb111b47003c79917fa", "account": { "id": "023e105f4ecef8ad9ca31a8372d0c353", "name": "Demo Account", "type": "standard", "created_on": "2014-03-01T12:21:02Z", "managed_by": { "parent_org_id": "4536bcfad5faccb111b47003c79917fa", "parent_org_name": "Demo Parent Organization" }, "settings": { "abuse_contact_email": "abuse_contact_email", "enforce_twofactor": true } }, "api_access_enabled": true, "permissions": { "analytics": { "read": true, "write": false }, "billing": { "read": true, "write": false }, "cache_purge": { "read": true, "write": false }, "dns": { "read": true, "write": false }, "dns_records": { "read": true, "write": false }, "lb": { "read": true, "write": false }, "logs": { "read": true, "write": false }, "organization": { "read": true, "write": false }, "ssl": { "read": true, "write": false }, "waf": { "read": true, "write": false }, "zone_settings": { "read": true, "write": false }, "zones": { "read": true, "write": true } }, "roles": [ "Account Administrator" ], "status": "accepted" } ], "result_info": { "count": 1, "page": 1, "per_page": 20, "total_count": 2000 } } ```