--- title: List Organizations --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/go) [User](https://developers.cloudflare.com/api/go/resources/user) [Organizations](https://developers.cloudflare.com/api/go/resources/user/subresources/organizations) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # List Organizations Deprecated client.User.Organizations.List(ctx, query) (\*V4PagePaginationArray\[[Organization]()], error) GET/user/organizations Lists organizations the user is associated with. ##### 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 OrganizationListParams

Direction param.Field\[OrganizationListParamsDirection]Optional Direction to order organizations.

const OrganizationListParamsDirectionAsc OrganizationListParamsDirection = "asc" Link to this property const OrganizationListParamsDirectionDesc OrganizationListParamsDirection = "desc" Link to this property

Link to this property

Match param.Field\[OrganizationListParamsMatch]Optional Whether to match all search requirements or at least one (any).

const OrganizationListParamsMatchAny OrganizationListParamsMatch = "any" Link to this property const OrganizationListParamsMatchAll OrganizationListParamsMatch = "all" Link to this property

Link to this property Name param.Field\[string]Optional Organization name. maxLength100 Link to this property

Order param.Field\[OrganizationListParamsOrder]Optional Field to order organizations by.

const OrganizationListParamsOrderID OrganizationListParamsOrder = "id" Link to this property const OrganizationListParamsOrderName OrganizationListParamsOrder = "name" Link to this property const OrganizationListParamsOrderStatus OrganizationListParamsOrder = "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 organizations per page. maximum50 minimum5 Link to this property

Status param.Field\[OrganizationListParamsStatus]Optional Whether the user is a member of the organization or has an inivitation pending.

const OrganizationListParamsStatusMember OrganizationListParamsStatus = "member" Link to this property const OrganizationListParamsStatusInvited OrganizationListParamsStatus = "invited" Link to this property

Link to this property

[Link to this property](<#(resource)%20user.organizations%20%3E%20(method)%20list%20%3E%20(params)%20default>) ##### ReturnsExpand Collapse

type Organization struct{…}

ID stringOptional Identifier maxLength32 minLength32 Link to this property Name stringOptional Organization name. maxLength100 Link to this property Permissions \[]PermissionOptional Access permissions for this User. Link to this property Roles \[]stringOptional List of roles that a user has within an organization. Link to this property

Status StatusOptional Whether the user is a member of the organization or has an invitation pending.

One of the following: const StatusMember Status = "member" Link to this property const StatusInvited Status = "invited" Link to this property

Link to this property

[Link to this property](<#(resource)%20user.organizations%20%3E%20(model)%20organization%20%3E%20(schema)>) ### List Organizations Go HTTPTypeScriptPythonGoTerraform ``` package main import ( "context" "fmt" "github.com/cloudflare/cloudflare-go" "github.com/cloudflare/cloudflare-go/option" "github.com/cloudflare/cloudflare-go/user" ) func main() { client := cloudflare.NewClient( option.WithAPIKey("144c9defac04969c7bfad8efaa8ea194"), option.WithAPIEmail("user@example.com"), ) page, err := client.User.Organizations.List(context.TODO(), user.OrganizationListParams{ }) 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": "023e105f4ecef8ad9ca31a8372d0c353", "name": "Cloudflare, Inc.", "permissions": [ "#zones:read" ], "roles": [ "All Privileges - Super Administrator" ], "status": "member" } ], "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": "023e105f4ecef8ad9ca31a8372d0c353", "name": "Cloudflare, Inc.", "permissions": [ "#zones:read" ], "roles": [ "All Privileges - Super Administrator" ], "status": "member" } ], "result_info": { "count": 1, "page": 1, "per_page": 20, "total_count": 2000 } } ```