---
title: "List DNS names in a zone"
method: GET
path: "/v1/dns/records/{zone_name}"
tags: ["records"]
---

# List DNS names in a zone

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

Lists the dns names of the user in a given zone.
Results can be sorted using the `sort` parameter,
and filtered by `name` metadata using metadata filter expressions.

## Path parameters

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

## Query parameters

- `offset` integer
- `limit` integer
- `sort` object
  - `name` 'asc' | 'desc'
  - `name_labels_reversed` 'asc' | 'desc'
  - `created_at` 'asc' | 'desc'
- `expand[]` string[]
- `metadata` string — A metadata filter expression See [metadata filters](metadata-filter-expressions) for an in-depth description of the expression syntax.

## Response `200`

success

- object
  - `data` DnsName[], required
    - `metadata` Metadata — A collection of string key/value pairs that provide additional information or classification for an object.
    - `name` string, required — The DNS name, not including the zone portion.
    - `update_group` string — Name of the update group
    - `is_published` boolean, required — Is the name published?
    - `is_offline` boolean, required — Is the name offline?
    - `is_write_prohibited` boolean, required — Name is write prohibited
    - `created_at` string, date-time, required — Created at
    - `name_labels_reversed` string, required — Name with the labels in reverse order
    - `offline_settings` OfflineSettings
      - `action` 'no_action' | 'ip' | 'web_redirect' | 'page', required
      - `ip` string, nullable — Ip address used when action is `ip`
      - `web_redirect` string, nullable — Url to redirect used when action is `url`
      - `page_title` string, nullable — Page title when action is `page`
      - `page_text` string, nullable — Page text when action is `page`
      - `page_email` string, nullable — Page contact email when action is `page`
      - `page_logo_url` string, nullable — Page logo when action is `page`
  - `page` PageInfo, required
    - `offset` integer, required
    - `limit` integer, required
    - `total` integer, required
  - `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.dev/noip/apis/no-ip-api.md) · [All operations](https://skmtc.dev/noip/apis/no-ip-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/noip/no-ip-api/revisions/619d78b2a70e/schema)