---
title: "List zone records"
method: GET
path: "/{account}/zones/{zone}/records"
tags: ["zones"]
---

# List zone records

`GET /{account}/zones/{zone}/records`

Lists the records for a zone.

## Path parameters

- `account` integer, required
- `zone` string, required

## Query parameters

- `name_like` string
- `name` string
- `type` string
- `sort` 'id:asc' | 'id:desc' | 'name:asc' | 'name:desc' | 'content:asc' | 'content:desc' | 'type:asc' | 'type:desc'

## Response `200`

Successfully retrieved zone records list.

- object
  - `data` ZoneRecord[], required
    - `id` integer, required — The unique identifier for the record.
    - `zone_id` string, required — The unique identifier of the zone this record belongs to
    - `parent_id` integer, nullable, required — If present represents the zone record this record relates to. The parent record is the master record, when the parent is updated or deleted the related record is also updated or deleted. An example of child record is the TXT descriptive record created for an ALIAS record.
    - `name` string, required — The name of the record (e.g., "www" for www.example.com).
    - `content` string, required — The content/value of the record (e.g., IP address for A records, hostname for CNAME records).
    - `ttl` integer, required — The Time To Live (TTL) value for the entry, in seconds.
    - `priority` integer, nullable, required — The priority value for MX and SRV records. Lower values have higher priority.
    - `type` 'A' | 'AAAA' | 'ALIAS' | 'CAA' | 'CNAME' | 'DNSKEY' | 'DS' | 'HINFO' | 'MX' | 'NAPTR' | 'NS' | 'POOL' | 'PTR' | 'SOA' | 'SPF' | 'SRV' | 'SSHFP' | 'TXT' | 'URL', required — The type of DNS record. Supported DNS record types are listed below. Note that some record types may only be available on specific plans.
    - `regions` ZoneRecordRegion[], required — The regions where this record is active. If empty, the record is active in all regions.
    - `system_record` boolean, required — Returns true if a record is a system generated record and thus is not modifiable.
    - `created_at` string, date-time, required — A date-time value, representing when the entry was created, formatted as ISO 8601.
    - `updated_at` string, date-time, required — A date-time value, representing when the entry was last updated, formatted as ISO 8601.
  - `pagination` Pagination, required
    - `current_page` integer, required
    - `per_page` integer, required
    - `total_entries` integer, required
    - `total_pages` integer, required

---

[API](https://skmtc.net/dnsimple/apis/dnsimple-api.md) · [All operations](https://skmtc.net/dnsimple/apis/dnsimple-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dnsimple/dnsimple-api/revisions/270bb4f6f532/schema)