--- title: List Zones --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api) [Zones](https://developers.cloudflare.com/api/resources/zones) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # List Zones GET/zones Lists, searches, sorts, and filters your zones. Listing zones across more than 500 accounts is currently not allowed. ##### Security

API Token

The preferred authorization scheme for interacting with the Cloudflare API. Create a token. **Example:**Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY

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) `Zone Zone Read` ##### Q uery ParametersExpand Collapse

account: optional object {id, name }

id: optional string Filter by an account ID. Link to this property name: optional string An account Name. Optional filter operators can be provided to extend refine the search: - equal (default) - not_equal - starts_with - ends_with - contains - starts_with_case_sensitive - ends_with_case_sensitive - contains_case_sensitive maxLength253 Link to this property

[Link to this property](<#(resource)%20zones%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20account%20%3E%20(schema)>)

direction: optional "asc"or "desc" Direction to order zones.

One of the following: "asc" Link to this property "desc" Link to this property

[Link to this property](<#(resource)%20zones%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20direction%20%3E%20(schema)>)

match: optional "any"or "all" Whether to match all search requirements or at least one (any).

One of the following: "any" Link to this property "all" Link to this property

[Link to this property](<#(resource)%20zones%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20match%20%3E%20(schema)>) name: optional string A domain name. Optional filter operators can be provided to extend refine the search: - `equal` (default) - `not_equal` - `starts_with` - `ends_with` - `contains` - `starts_with_case_sensitive` - `ends_with_case_sensitive` - `contains_case_sensitive` maxLength253 [Link to this property](<#(resource)%20zones%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20name%20%3E%20(schema)>)

order: optional "name"or "status"or "account.id"or 2 more Field to order zones by.

One of the following: "name" Link to this property "status" Link to this property "account.id" Link to this property "account.name" Link to this property "plan.id" Link to this property

[Link to this property](<#(resource)%20zones%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20order%20%3E%20(schema)>) page: optional number Page number of paginated results. minimum1 [Link to this property](<#(resource)%20zones%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20page%20%3E%20(schema)>) per\_page: optional number Number of zones per page. maximum50 minimum5 [Link to this property](<#(resource)%20zones%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20per_page%20%3E%20(schema)>)

status: optional "initializing"or "pending"or "active"or "moved" Specify a zone status to filter by.

One of the following: "initializing" Link to this property "pending" Link to this property "active" Link to this property "moved" Link to this property

[Link to this property](<#(resource)%20zones%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20status%20%3E%20(schema)>)

type: optional array of "full"or "partial"or "secondary"or "internal" Zone types to filter by. Multiple types can be specified as a comma-separated list (e.g., ?type=full,partial,secondary). When this parameter is not provided, zones with type “internal” are excluded from the results.

One of the following: "full" Link to this property "partial" Link to this property "secondary" Link to this property "internal" Link to this property

[Link to this property](<#(resource)%20zones%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20type%20%3E%20(schema)>) ##### ReturnsExpand Collapse

errors: 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)%20zones%20%3E%20(method)%20list%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)%20zones%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20messages>) success: boolean Whether the API call was successful. [Link to this property](<#(resource)%20zones%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20success>)

result: optional array of Zone { id, account, activated\_on, 20 more }

id: string Identifier maxLength32 Link to this property

account: object {id, name } The account the zone belongs to.

id: optional string Identifier maxLength32 Link to this property name: optional string The name of the account. Link to this property

Link to this property activated\_on: string The last time proof of ownership was detected and the zone was made active. formatdate-time Link to this property created\_on: string When the zone was created. formatdate-time Link to this property development\_mode: number The interval (in seconds) from when development mode expires (positive integer) or last expired (negative integer) for the domain. If development mode has never been enabled, this value is 0. Link to this property

meta: object {cdn\_only, custom\_certificate\_quota, dns\_only, 4 more } Metadata about the zone.

cdn\_only: optional boolean The zone is only configured for CDN. Link to this property custom\_certificate\_quota: optional number Number of Custom Certificates the zone can have. Link to this property dns\_only: optional boolean The zone is only configured for DNS. Link to this property foundation\_dns: optional boolean The zone is setup with Foundation DNS. Link to this property page\_rule\_quota: optional number Number of Page Rules a zone can have. Link to this property phishing\_detected: optional boolean The zone has been flagged for phishing. Link to this property step: optional number Link to this property

Link to this property modified\_on: string When the zone was last modified. formatdate-time Link to this property name: string The domain name. Per RFC 1035 the overall zone name can be up to 253 characters, with each segment (“label”) not exceeding 63 characters. maxLength253 Link to this property name\_servers: array of string The name servers Cloudflare assigns to a zone. Link to this property original\_dnshost: string DNS host at the time of switching to Cloudflare. maxLength50 Link to this property original\_name\_servers: array of string Original name servers before moving to Cloudflare. Link to this property original\_registrar: string Registrar for the domain at the time of switching to Cloudflare. Link to this property

owner: object {id, name, type } The owner of the zone.

id: optional string Identifier maxLength32 Link to this property name: optional string Name of the owner. Link to this property type: optional string The type of owner. Link to this property

Link to this property

Deprecatedplan: object {id, can\_subscribe, currency, 7 more } Please use the /zones/{zone_id}/subscription API to update a zone’s plan. Changing this value will create/cancel associated subscriptions. To view available plans for this zone, see Zone Plans. A Zones subscription information.

id: optional string Identifier maxLength32 Link to this property can\_subscribe: optional boolean States if the subscription can be activated. Link to this property currency: optional string The denomination of the customer. Link to this property externally\_managed: optional boolean If this Zone is managed by another company. Link to this property frequency: optional string How often the customer is billed. Link to this property is\_subscribed: optional boolean States if the subscription active. Link to this property legacy\_discount: optional boolean If the legacy discount applies to this Zone. Link to this property legacy\_id: optional string The legacy name of the plan. Link to this property name: optional string Name of the owner. Link to this property price: optional number How much the customer is paying. Link to this property

Link to this property cname\_suffix: optional string Allows the customer to use a custom apex. *Tenants Only Configuration*. Link to this property paused: optional boolean Indicates whether the zone is only using Cloudflare DNS services. A true value means the zone will not receive security or performance benefits. Link to this property Deprecatedpermissions: optional array of string This has been replaced by Account memberships. Legacy permissions based on legacy user membership information. Link to this property

status: optional "initializing"or "pending"or "active"or "moved" The zone status on Cloudflare.

One of the following: "initializing" Link to this property "pending" Link to this property "active" Link to this property "moved" Link to this property

Link to this property

tenant: optional object {id, name } The root organizational unit that this zone belongs to (such as a tenant or organization).

id: optional string Identifier maxLength32 Link to this property name: optional string The name of the Tenant account. Link to this property

Link to this property

tenant\_unit: optional object {id } The immediate parent organizational unit that this zone belongs to (such as under a tenant or sub-organization).

id: optional string Identifier maxLength32 Link to this property

Link to this property

type: optional Type A full zone implies that DNS is hosted with Cloudflare. A partial zone is typically a partner-hosted zone or a CNAME setup.

One of the following: "full" Link to this property "partial" Link to this property "secondary" Link to this property "internal" Link to this property

Link to this property vanity\_name\_servers: optional array of string An array of domains used for custom name servers. This is only available for Business and Enterprise plans. Link to this property verification\_key: optional string Verification key for partial zone setup. Link to this property

[Link to this property](<#(resource)%20zones%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20result>)

result\_info: optional object {count, page, per\_page, 2 more }

count: optional number Total number of results for the requested service. Link to this property page: optional number Current page within paginated list of results. Link to this property per\_page: optional number Number of results per page of results. Link to this property total\_count: optional number Total results available without any search parameters. Link to this property total\_pages: optional number Total number of pages Link to this property

[Link to this property](<#(resource)%20zones%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20result_info>) ### List Zones HTTP HTTPTypeScriptPythonGoTerraform ``` curl https://api.cloudflare.com/client/v4/zones \ -H "Authorization: Bearer $CLOUDFLARE_API_TOKEN" ``` 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", "account": { "id": "023e105f4ecef8ad9ca31a8372d0c353", "name": "Example Account Name" }, "activated_on": "2014-01-02T00:01:00.12345Z", "created_on": "2014-01-01T05:20:00.12345Z", "development_mode": 7200, "meta": { "cdn_only": true, "custom_certificate_quota": 1, "dns_only": true, "foundation_dns": true, "page_rule_quota": 100, "phishing_detected": false, "step": 2 }, "modified_on": "2014-01-01T05:20:00.12345Z", "name": "example.com", "name_servers": [ "bob.ns.cloudflare.com", "lola.ns.cloudflare.com" ], "original_dnshost": "NameCheap", "original_name_servers": [ "ns1.originaldnshost.com", "ns2.originaldnshost.com" ], "original_registrar": "GoDaddy", "owner": { "id": "023e105f4ecef8ad9ca31a8372d0c353", "name": "Example Org", "type": "organization" }, "plan": { "id": "023e105f4ecef8ad9ca31a8372d0c353", "can_subscribe": false, "currency": "USD", "externally_managed": false, "frequency": "monthly", "is_subscribed": false, "legacy_discount": false, "legacy_id": "free", "name": "Example Org", "price": 10.99 }, "cname_suffix": "cdn.cloudflare.com", "paused": true, "permissions": [ "#worker:read" ], "status": "active", "tenant": { "id": "023e105f4ecef8ad9ca31a8372d0c353", "name": "Example Account Name" }, "tenant_unit": { "id": "023e105f4ecef8ad9ca31a8372d0c353" }, "type": "full", "vanity_name_servers": [ "ns1.example.com", "ns2.example.com" ], "verification_key": "284344499-1084221259" } ], "result_info": { "count": 1, "page": 1, "per_page": 20, "total_count": 2000, "total_pages": 100 } } ``` ##### 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", "account": { "id": "023e105f4ecef8ad9ca31a8372d0c353", "name": "Example Account Name" }, "activated_on": "2014-01-02T00:01:00.12345Z", "created_on": "2014-01-01T05:20:00.12345Z", "development_mode": 7200, "meta": { "cdn_only": true, "custom_certificate_quota": 1, "dns_only": true, "foundation_dns": true, "page_rule_quota": 100, "phishing_detected": false, "step": 2 }, "modified_on": "2014-01-01T05:20:00.12345Z", "name": "example.com", "name_servers": [ "bob.ns.cloudflare.com", "lola.ns.cloudflare.com" ], "original_dnshost": "NameCheap", "original_name_servers": [ "ns1.originaldnshost.com", "ns2.originaldnshost.com" ], "original_registrar": "GoDaddy", "owner": { "id": "023e105f4ecef8ad9ca31a8372d0c353", "name": "Example Org", "type": "organization" }, "plan": { "id": "023e105f4ecef8ad9ca31a8372d0c353", "can_subscribe": false, "currency": "USD", "externally_managed": false, "frequency": "monthly", "is_subscribed": false, "legacy_discount": false, "legacy_id": "free", "name": "Example Org", "price": 10.99 }, "cname_suffix": "cdn.cloudflare.com", "paused": true, "permissions": [ "#worker:read" ], "status": "active", "tenant": { "id": "023e105f4ecef8ad9ca31a8372d0c353", "name": "Example Account Name" }, "tenant_unit": { "id": "023e105f4ecef8ad9ca31a8372d0c353" }, "type": "full", "vanity_name_servers": [ "ns1.example.com", "ns2.example.com" ], "verification_key": "284344499-1084221259" } ], "result_info": { "count": 1, "page": 1, "per_page": 20, "total_count": 2000, "total_pages": 100 } } ```