---
title: Zones
summary: A zone is a specific segment of the Domain Name System (DNS) namespace that can be managed and maintained on Fastly DNS.
url: https://www.fastly.com/documentation/reference/api/dns/zones
---

A zone is a specific segment of the Domain Name System (DNS) namespace that can be managed and maintained on Fastly DNS.

## Data model

| Field | Type | Description |
|-------|------|-------------|
| `errors` | array |  |

## Data model

| Field | Type | Description |
|-------|------|-------------|
| `ipv4` | array | IPv4 addresses where Primary DNS servers can send NOTIFY messages. |

## Data model

| Field | Type | Description |
|-------|------|-------------|
| `address` | string | An IPv4 address for the Primary DNS Server. |
| `description` | string | A description of the Primary DNS server. |

## Data model

| Field | Type | Description |
|-------|------|-------------|
| `description` | string | A freeform descriptive note. |
| `name` | string | The domain name for your zone. |
| `type` | string | The type of the zone. |
| `xfr_config_inbound` | object | All attributes associated with inbound zone transfers. |

## Data model

| Field | Type | Description |
|-------|------|-------------|
| `description` | string | A freeform descriptive note. |
| `xfr_config_inbound` | object | All attributes associated with inbound zone transfers. |

## Data model

| Field | Type | Description |
|-------|------|-------------|
| `created_at` | string | Date and time in ISO 8601 format. (Read-only) |
| `description` | string | A freeform descriptive note. |
| `id` | string | Zone Identifier (UUID). |
| `name` | string | The domain name for your zone. |
| `type` | string | The type of the zone. |
| `updated_at` | string | Date and time in ISO 8601 format. (Read-only) |

## Data model

| Field | Type | Description |
|-------|------|-------------|
| `created_at` | string | Date and time in ISO 8601 format. (Read-only) |
| `description` | string | A freeform descriptive note. |
| `id` | string | Zone Identifier (UUID). |
| `name` | string | The domain name for your zone. |
| `nameservers` | array | An array of the nameserver hostnames assigned to the zone. |
| `serial` | string | The serial number of the zone's SOA record. |
| `type` | string | The type of the zone. |
| `updated_at` | string | Date and time in ISO 8601 format. (Read-only) |
| `xfr_config_inbound` | object | All attributes associated with inbound zone transfers. |

## Data model

| Field | Type | Description |
|-------|------|-------------|
| `inbound_tsig_key_id` | string | The ID of the TSIG key used to secure inbound zone transfers. |
| `primaries` | array | An array of the primary DNS server objects associated with inbound zone transfers. |

## Data model

| Field | Type | Description |
|-------|------|-------------|
| `inbound_tsig_key_id` | string | The ID of the TSIG key used to secure inbound zone transfers. |
| `notify_ip_addresses` | object | IP addresses where Primary DNS servers can send NOTIFY messages. |
| `primaries` | array | An array of the primary DNS server objects associated with inbound zone transfers. |

## API endpoints

### Get zones

**GET** `/dns/v1/zones`

Retrieve a paginated list of all zones.

**Parameters:**

| Name | Type | In | Required | Description |
|------|------|----|---------|--------------|
| `cursor` | string | query | No | Cursor value from the <code>next_cursor</code> field of a previous response, used to retrieve the next page. To request the first page, this should be empty. |
| `limit` | integer | query | No | Limit how many results are returned. |
| `name` | string | query | No | Filters the list to return only zones that contain the provided name. |
| `sort` | string | query | No | The order in which to list the results. |

### Create zone

**POST** `/dns/v1/zones`

Create a new zone.

### Get zone

**GET** `/dns/v1/zones/{zone_id}`

Retrieve a specific zone.

**Parameters:**

| Name | Type | In | Required | Description |
|------|------|----|---------|--------------|
| `zone_id` | string | path | Yes | The Zone Identifier (UUID). |

### Delete zone

**DELETE** `/dns/v1/zones/{zone_id}`

Delete a specific zone.

**Parameters:**

| Name | Type | In | Required | Description |
|------|------|----|---------|--------------|
| `zone_id` | string | path | Yes | The Zone Identifier (UUID). |

### Update zone

**PATCH** `/dns/v1/zones/{zone_id}`

Update a specific zone.

**Parameters:**

| Name | Type | In | Required | Description |
|------|------|----|---------|--------------|
| `zone_id` | string | path | Yes | The Zone Identifier (UUID). |