---
title: "List of Zones"
method: GET
path: "/dns/v2/zones"
tags: ["Zones"]
---

# List of Zones

`GET /dns/v2/zones`

Show created zones with pagination managed by limit and offset params. All query params are optional.

## Query parameters

- `offset` integer
- `limit` integer
- `order_by` string
- `order_direction` 'asc' | 'desc'
- `id` integer[]
- `client_id` integer[]
- `reseller_id` integer[]
- `iam_reseller_id` integer[]
- `name` string[]
- `case_sensitive` boolean
- `exact_match` boolean
- `enabled` boolean
- `status` string
- `dynamic` boolean
- `healthcheck` boolean
- `updated_at_from` string, date-time
- `updated_at_to` string, date-time

## Response `200`

ListZoneResponse

- ListZoneResponse
  - `total_amount` integer
  - `zones` OutputZone[]
    - `client_id` integer
    - `contact` string — email address of the administrator responsible for this zone
    - `dnssec_enabled` boolean — describe dnssec status true means dnssec is enabled for the zone false means dnssec is disabled for the zone
    - `enabled` boolean
    - `expiry` integer — number of seconds after which secondary name servers should stop answering request for this zone
    - `id` integer — ID of zone. This field usually is omitted in response and available only in case of getting deleted zones by admin.
    - `meta` object — arbitrarily data of zone in json format
    - `name` string — name of DNS zone
    - `nx_ttl` integer — Time To Live of cache
    - `primary_server` string — primary master name server for zone
    - `records` Record[]
      - `name` string
      - `short_answers` string[]
      - `ttl` integer
      - `type` string
    - `refresh` integer — number of seconds after which secondary name servers should query the master for the SOA record, to detect zone changes.
    - `retry` integer — number of seconds after which secondary name servers should retry to request the serial number
    - `rrsets_amount` RRSetsAmount
      - `dynamic` object — Amount of dynamic RRsets in zone
        - `healthcheck` integer — Amount of RRsets with enabled healthchecks
        - `total` integer — Total amount of dynamic RRsets in zone
      - `static` integer — Amount of static RRsets in zone
      - `total` integer — Total amount of RRsets in zone
    - `serial` integer — Serial number for this zone or Timestamp of zone modification moment. If a secondary name server slaved to this one observes an increase in this number, the slave will assume that the zone has been updated and initiate a zone transfer.
    - `status` string

## Other responses

- `400` — Error message response

---

[API](https://skmtc.net/g-core/apis/gcore-openapi.md) · [All operations](https://skmtc.net/g-core/apis/gcore-openapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/g-core/gcore-openapi/revisions/09e652815095/schema)