---
title: List organization accounts
---
[Skip to content](#_top)
[API Reference](https://developers.cloudflare.com/api)
[Organizations](https://developers.cloudflare.com/api/resources/organizations)
[Organization Accounts](https://developers.cloudflare.com/api/resources/organizations/subresources/organization_accounts)
Copy Markdown
Open in **Claude**Open in **ChatGPT**Open in **Cursor**
---
**Copy Markdown****View as Markdown**
# List organization accounts
GET/organizations/{organization\_id}/accounts
Retrieve the accounts immediately attached to a specific organization. Accounts attached to sub-organizations are not included. (Currently in Public Beta - see https://developers.cloudflare.com/fundamentals/organizations/)
##### 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`
##### P ath ParametersExpand Collapse
organization\_id: string
[Link to this property](<#(resource)%20organizations.organization_accounts%20%3E%20(method)%20get%20%3E%20(params)%20default%20%3E%20(param)%20organization_id%20%3E%20(schema)>)
##### Q uery ParametersExpand Collapse
account\_pubname: optional object {contains, endsWith, startsWith }
contains: optional string
(case-insensitive) Filter the list of accounts to where the account\_pubname contains a particular string.
Link to this property
endsWith: optional string
(case-insensitive) Filter the list of accounts to where the account\_pubname ends with a particular string.
Link to this property
startsWith: optional string
(case-insensitive) Filter the list of accounts to where the account\_pubname starts with a particular string.
Link to this property
[Link to this property](<#(resource)%20organizations.organization_accounts%20%3E%20(method)%20get%20%3E%20(params)%20default%20%3E%20(param)%20account_pubname%20%3E%20(schema)>)
direction: optional "asc"or "desc"
Sort direction for the order\_by field. Valid values: asc, desc. Defaults to asc when order\_by is specified.
One of the following:
"asc"
Link to this property
"desc"
Link to this property
[Link to this property](<#(resource)%20organizations.organization_accounts%20%3E%20(method)%20get%20%3E%20(params)%20default%20%3E%20(param)%20direction%20%3E%20(schema)>)
include\_tags: optional boolean
Include Account tags from the resource tag mirror. Omit this parameter to preserve the existing Account response shape.
[Link to this property](<#(resource)%20organizations.organization_accounts%20%3E%20(method)%20get%20%3E%20(params)%20default%20%3E%20(param)%20include_tags%20%3E%20(schema)>)
include\_total: optional boolean
Whether to calculate and return the exact result\_info.total\_size for cursor pagination. Defaults to true. When false, total\_size is omitted. page\_size and include\_total may change between pages; next\_page\_token remains the authoritative continuation signal. Legacy page/per\_page requests always calculate total\_count.
[Link to this property](<#(resource)%20organizations.organization_accounts%20%3E%20(method)%20get%20%3E%20(params)%20default%20%3E%20(param)%20include_total%20%3E%20(schema)>)
name: optional object {contains, endsWith, startsWith }
contains: optional string
(case-insensitive) Filter the list of accounts to where the name contains a particular string.
Link to this property
endsWith: optional string
(case-insensitive) Filter the list of accounts to where the name ends with a particular string.
Link to this property
startsWith: optional string
(case-insensitive) Filter the list of accounts to where the name starts with a particular string.
Link to this property
[Link to this property](<#(resource)%20organizations.organization_accounts%20%3E%20(method)%20get%20%3E%20(params)%20default%20%3E%20(param)%20name%20%3E%20(schema)>)
order\_by: optional "account\_name"
Field to order results by. Currently supported values: `account_name`. When not specified, results are ordered by internal account ID.
[Link to this property](<#(resource)%20organizations.organization_accounts%20%3E%20(method)%20get%20%3E%20(params)%20default%20%3E%20(param)%20order_by%20%3E%20(schema)>)
page\_size: optional number
The amount of items to return. Defaults to 10.
maximum1000
minimum0
[Link to this property](<#(resource)%20organizations.organization_accounts%20%3E%20(method)%20get%20%3E%20(params)%20default%20%3E%20(param)%20page_size%20%3E%20(schema)>)
page\_token: optional string
An opaque token returned from the last list response that when provided will retrieve the next page.
Parameters used to filter the retrieved list must remain in subsequent requests with a page token.
[Link to this property](<#(resource)%20organizations.organization_accounts%20%3E%20(method)%20get%20%3E%20(params)%20default%20%3E%20(param)%20page_token%20%3E%20(schema)>)
##### ReturnsExpand Collapse
errors: array of unknown
[Link to this property](<#(resource)%20organizations.organization_accounts%20%3E%20(method)%20get%20%3E%20(network%20schema)%20%3E%20(property)%20errors>)
messages: array of ResponseInfo { code, message, documentation\_url, source }
code: number
minimum1000
Link to this property
message: string
Link to this property
documentation\_url: optional string
Link to this property
source: optional object {pointer }
pointer: optional string
Link to this property
Link to this property
[Link to this property](<#(resource)%20organizations.organization_accounts%20%3E%20(method)%20get%20%3E%20(network%20schema)%20%3E%20(property)%20messages>)
result: array of TenantAccount { id, created\_on, name, 3 more }
id: string
Link to this property
created\_on: string
formatdate-time
Link to this property
name: string
Link to this property
settings: object {abuse\_contact\_email, access\_approval\_expiry, api\_access\_enabled, 3 more }
abuse\_contact\_email: string
Link to this property
access\_approval\_expiry: string
formatdate-time
Link to this property
api\_access\_enabled: boolean
Link to this property
Deprecateddefault\_nameservers: string
Use DNS Settings instead. Deprecated.
Link to this property
enforce\_twofactor: boolean
Link to this property
Deprecateduse\_account\_custom\_ns\_by\_default: boolean
Use DNS Settings instead. Deprecated.
Link to this property
Link to this property
type: "standard"or "enterprise"
One of the following:
"standard"
Link to this property
"enterprise"
Link to this property
Link to this property
tags: optional map\[string]
Account tags, present only when include_tags=true is requested.
Link to this property
[Link to this property](<#(resource)%20organizations.organization_accounts%20%3E%20(method)%20get%20%3E%20(network%20schema)%20%3E%20(property)%20result>)
result\_info: object {next\_page\_token, total\_size }
next\_page\_token: optional string
Use this opaque token in the next request to retrieve the next page.
Parameters used to filter the retrieved list must remain in subsequent requests with a page token.
Link to this property
total\_size: optional number
Counts the total amount of items in a list with the applied filters. The API omits next\_page\_token to indicate no more items in a particular list.
Link to this property
[Link to this property](<#(resource)%20organizations.organization_accounts%20%3E%20(method)%20get%20%3E%20(network%20schema)%20%3E%20(property)%20result_info>)
success: true
[Link to this property](<#(resource)%20organizations.organization_accounts%20%3E%20(method)%20get%20%3E%20(network%20schema)%20%3E%20(property)%20success>)
### List organization accounts
HTTP
HTTPTypeScriptPythonGoTerraform
```
curl https://api.cloudflare.com/client/v4/organizations/$ORGANIZATION_ID/accounts \
-H "X-Auth-Email: $CLOUDFLARE_EMAIL" \
-H "X-Auth-Key: $CLOUDFLARE_API_KEY"
```
200 example
```
{
"errors": [],
"messages": [
{
"code": 1000,
"message": "message",
"documentation_url": "documentation_url",
"source": {
"pointer": "pointer"
}
}
],
"result": [
{
"id": "id",
"created_on": "2019-12-27T18:11:19.117Z",
"name": "name",
"settings": {
"abuse_contact_email": "abuse_contact_email",
"access_approval_expiry": "2019-12-27T18:11:19.117Z",
"api_access_enabled": true,
"default_nameservers": "default_nameservers",
"enforce_twofactor": true,
"use_account_custom_ns_by_default": true
},
"type": "standard",
"tags": {
"foo": "string"
}
}
],
"result_info": {
"next_page_token": "next_page_token",
"total_size": 0
},
"success": true
}
```
##### Returns Examples
200 example
```
{
"errors": [],
"messages": [
{
"code": 1000,
"message": "message",
"documentation_url": "documentation_url",
"source": {
"pointer": "pointer"
}
}
],
"result": [
{
"id": "id",
"created_on": "2019-12-27T18:11:19.117Z",
"name": "name",
"settings": {
"abuse_contact_email": "abuse_contact_email",
"access_approval_expiry": "2019-12-27T18:11:19.117Z",
"api_access_enabled": true,
"default_nameservers": "default_nameservers",
"enforce_twofactor": true,
"use_account_custom_ns_by_default": true
},
"type": "standard",
"tags": {
"foo": "string"
}
}
],
"result_info": {
"next_page_token": "next_page_token",
"total_size": 0
},
"success": true
}
```