--- title: List Memberships --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/go) [Memberships](https://developers.cloudflare.com/api/go/resources/memberships) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # List Memberships client.Memberships.List(ctx, query) (\*V4PagePaginationArray\[[Membership]()], error) 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
query MembershipListParams
Account param.Field\[MembershipListParamsAccount]Optional Name stringOptional Account name maxLength100 Link to this property
Link to this property
Direction param.Field\[MembershipListParamsDirection]Optional Direction to order memberships. const MembershipListParamsDirectionAsc MembershipListParamsDirection = "asc" Link to this property const MembershipListParamsDirectionDesc MembershipListParamsDirection = "desc" Link to this property
Link to this property Name param.Field\[string]Optional Account name maxLength100 Link to this property
Order param.Field\[MembershipListParamsOrder]Optional Field to order memberships by. const MembershipListParamsOrderID MembershipListParamsOrder = "id" Link to this property const MembershipListParamsOrderAccountName MembershipListParamsOrder = "account.name" Link to this property const MembershipListParamsOrderStatus MembershipListParamsOrder = "status" Link to this property
Link to this property Page param.Field\[float64]Optional Page number of paginated results. minimum1 Link to this property PerPage param.Field\[float64]Optional Number of memberships per page. maximum50 minimum5 Link to this property
Status param.Field\[MembershipListParamsStatus]Optional Status of this membership. const MembershipListParamsStatusAccepted MembershipListParamsStatus = "accepted" Link to this property const MembershipListParamsStatusPending MembershipListParamsStatus = "pending" Link to this property const MembershipListParamsStatusRejected MembershipListParamsStatus = "rejected" Link to this property
Link to this property
[Link to this property](<#(resource)%20memberships%20%3E%20(method)%20list%20%3E%20(params)%20default>) ##### ReturnsExpand Collapse
type Membership struct{…} ID stringOptional Membership identifier tag. maxLength32 Link to this property
Account AccountOptional ID string Identifier maxLength32 minLength32 Link to this property Name string Account name maxLength100 Link to this property
Type AccountType One of the following: const AccountTypeStandard AccountType = "standard" Link to this property const AccountTypeEnterprise AccountType = "enterprise" Link to this property
Link to this property CreatedOn TimeOptional Timestamp for the creation of the account formatdate-time Link to this property
ManagedBy AccountManagedByOptional Parent container details ParentOrgID stringOptional ID of the parent Organization, if one exists maxLength32 Link to this property ParentOrgName stringOptional Name of the parent Organization, if one exists Link to this property
Link to this property
Settings AccountSettingsOptional Account settings AbuseContactEmail stringOptional Sets an abuse contact email to notify for abuse reports. Link to this property EnforceTwofactor boolOptional 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 APIAccessEnabled boolOptional Enterprise only. Indicates whether or not API access is enabled specifically for this user on a given account. Link to this property
Permissions MembershipPermissionsOptional All access permissions for the user at the account.
Analytics PermissionGrantOptional Read boolOptional Link to this property Write boolOptional Link to this property
Link to this property
Billing PermissionGrantOptional Read boolOptional Link to this property Write boolOptional Link to this property
Link to this property
CachePurge PermissionGrantOptional Read boolOptional Link to this property Write boolOptional Link to this property
Link to this property
DNS PermissionGrantOptional Read boolOptional Link to this property Write boolOptional Link to this property
Link to this property
DNSRecords PermissionGrantOptional Read boolOptional Link to this property Write boolOptional Link to this property
Link to this property
LB PermissionGrantOptional Read boolOptional Link to this property Write boolOptional Link to this property
Link to this property
Logs PermissionGrantOptional Read boolOptional Link to this property Write boolOptional Link to this property
Link to this property
Organization PermissionGrantOptional Read boolOptional Link to this property Write boolOptional Link to this property
Link to this property
SSL PermissionGrantOptional Read boolOptional Link to this property Write boolOptional Link to this property
Link to this property
WAF PermissionGrantOptional Read boolOptional Link to this property Write boolOptional Link to this property
Link to this property
ZoneSettings PermissionGrantOptional Read boolOptional Link to this property Write boolOptional Link to this property
Link to this property
Zones PermissionGrantOptional Read boolOptional Link to this property Write boolOptional Link to this property
Link to this property
Link to this property Roles \[]stringOptional List of role names the membership has for this account. Link to this property
Status MembershipStatusOptional Status of this membership. One of the following: const MembershipStatusAccepted MembershipStatus = "accepted" Link to this property const MembershipStatusPending MembershipStatus = "pending" Link to this property const MembershipStatusRejected MembershipStatus = "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 Go HTTPTypeScriptPythonGoTerraform ``` package main import ( "context" "fmt" "github.com/cloudflare/cloudflare-go" "github.com/cloudflare/cloudflare-go/memberships" "github.com/cloudflare/cloudflare-go/option" ) func main() { client := cloudflare.NewClient( option.WithAPIKey("144c9defac04969c7bfad8efaa8ea194"), option.WithAPIEmail("user@example.com"), ) page, err := client.Memberships.List(context.TODO(), memberships.MembershipListParams{ }) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", page) } ``` 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 } } ```