---
title: Zone Details
---
[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**
# Zone Details
GET/zones/{zone\_id}
Retrieves detailed information about a specific zone identified by its zone ID.
Returns zone configuration, status, nameservers, and associated metadata.
##### 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)
`Trust and Safety Write``Trust and Safety Read``Zero Trust: PII Read``Zaraz Edit``Zaraz Read``Zaraz Admin``Access: Apps and Policies Revoke``Access: Apps and Policies Write``Access: Apps and Policies Read``Access: Apps and Policies Revoke``Access: Mutual TLS Certificates Write``Access: Organizations, Identity Providers, and Groups Write``Zone Settings Write``Zone Settings Read``Zone Read``DNS Read``Workers Scripts Write``Workers Scripts Read``Zone Write``Workers Routes Write``Workers Routes Read``Stream Write``Stream Read``SSL and Certificates Write``SSL and Certificates Read``Logs Write``Logs Read``Cache Purge``Page Rules Write``Page Rules Read``Load Balancers Write``Load Balancers Read``Firewall Services Write``Firewall Services Read``DNS Write``Apps Write``Analytics Read``Access: Apps and Policies Write``Access: Apps and Policies Read`
##### P ath ParametersExpand Collapse
zone\_id: string
Identifier
maxLength32
[Link to this property](<#(resource)%20zones%20%3E%20(method)%20get%20%3E%20(params)%20default%20%3E%20(param)%20zone_id%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)%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)%20zones%20%3E%20(method)%20get%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)%20get%20%3E%20(network%20schema)%20%3E%20(property)%20success>)
result: optional 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)%20get%20%3E%20(network%20schema)%20%3E%20(property)%20result>)
### Zone Details
HTTP
HTTPTypeScriptPythonGoTerraform
```
curl https://api.cloudflare.com/client/v4/zones/$ZONE_ID \
-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"
}
}
```
##### 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"
}
}
```