---
title: "Get a zone"
method: GET
path: "/v1/dns/zones/{zone_name}"
tags: ["zones"]
---

# Get a zone

`GET /v1/dns/zones/{zone_name}`

Get detailed information about a zone.

## Path parameters

- `zone_name` string, required — The name of the zone.

## Query parameters

- `expand[]` string[]

## Response `200`

DNS zone of authority

- object — DNS zone of authority
  - `data` union, required — DNS zone of authority
    - object — Zone summary, including group options.
      - `name` string, required — The name of the zone.
      - `zone_type` 'primary' | 'secondary', required — Zone type
      - `is_owner` boolean, required — Is the zone owned by the user?
      - `zone_authority` string — ## Identifier A string type that has a limited character set, which makes it useful as an easy to type identifier for use in things like URL paths. The restrictions are alphanumeric characters (Unicode is permitted), plus dashes and underscore except for the initial character.
      - `nx_ttl` integer, required — Negative caching (NXDOMAIN, etc) time-to-live (seconds)
      - `publication_state` 'publish_requested' | 'published' | 'publish_failed' | 'unpublish_requested' | 'unpublished', required — Publication state for zone
      - `publication_failure` string, nullable — Publication failure reason
      - `is_write_prohibited` boolean, required — Zone is write prohibited
      - `shared_in_group` string — ## Identifier A string type that has a limited character set, which makes it useful as an easy to type identifier for use in things like URL paths. The restrictions are alphanumeric characters (Unicode is permitted), plus dashes and underscore except for the initial character.
      - `dns_name_count` integer, nullable — Count of dns names in the zone.
      - `rdata_count` integer, nullable — Count of rdata in the zone.
      - `metadata` Metadata — A collection of string key/value pairs that provide additional information or classification for an object.
      - `created_at` string, date-time, required — Created at
      - `updated_at` string, date-time, required — Updated at
    - object — DNS zone of authority
      - `name` string, required — The name of the zone.
      - `zone_type` 'primary' | 'secondary', required — Zone type
      - `is_owner` boolean, required — Is the zone owned by the user?
      - `dns_name_count` integer, nullable — Count of dns names in the zone.
      - `rdata_count` integer, nullable — Count of rdata in the zone.
  - `warnings` Warning[]
    - `code` string, required — A code for this warning.
    - `title` string, required — A title for this warning.
    - `detail` string, nullable — Contextual information about this warning.

## Other responses

- `401` — unauthorized (code: 2465)
- `403` — operation only available via the website (code: 4786)
- `404` — Multiple error variants are possible: - zone not found (code: 2510) - zone not shared (code: 2728)

---

[API](https://skmtc.net/noip/apis/no-ip-api.md) · [All operations](https://skmtc.net/noip/apis/no-ip-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/noip/no-ip-api/revisions/619d78b2a70e/schema)