# List Records

Lists all DNS records for a specified domain.

Endpoint: GET /core/v1/domains/{domainName}/records
Version: 1.3.1
Security: BasicAuth

## Path parameters:

  - `domainName` (string, required)
    DomainName is the zone to list the records for.

## Query parameters:

  - `perPage` (integer)
    Per Page is the number of records to return per request. Per Page defaults to 1,000.

  - `page` (integer)
    Page is which page to return.

## Response 200 fields (application/json):

  - `lastPage` (integer)
    LastPage is the identifier for the final page of results. It is only populated if there is another page of results after the current page.

  - `nextPage` (integer)
    NextPage is the identifier for the next page of results. It is only populated if there is another page of results after the current page.

  - `totalCount` (integer, required)
    TotalCount is total number of results.

  - `from` (integer, required)
    From specifies starting record number on current page.

  - `to` (integer, required)
    To specifies ending record number on current page.

  - `records` (array, required)

  - `records.answer` (string)
    Answer is either the IP address for A or AAAA records; the target for ANAME, CNAME, MX, or NS records; the text for TXT records.
For SRV records, answer has the following format: "{weight} {port} {target}" e.g. "1 5061 sip.example.org".

  - `records.domainName` (string)
    DomainName is the zone that the record belongs to.

  - `records.fqdn` (string)
    FQDN is the Fully Qualified Domain Name. It is the combination of the host and the domain name. It always ends in a ".". FQDN is ignored in CreateRecord, specify via the Host field instead.

  - `records.host` (string,null)
    Host is the hostname relative to the zone: e.g. for a record for blog.example.org, domain would be "example.org" and host would be "blog".
An apex record would be specified by either an empty host "" or "@".
A SRV record would be specified by "_{service}._{protocol}.{host}": e.g. "_sip._tcp.phone" for _sip._tcp.phone.example.org.

  - `records.id` (integer)
    Unique record id. Value is ignored on Create, and must match the URI on Update.

  - `records.priority` (integer)
    Priority is only required for MX and SRV records, it is ignored for all others.

  - `records.ttl` (integer, required)
    TTL is the time this record can be cached for in seconds. name.com allows a minimum TTL of 300, or 5 minutes.

  - `records.type` (string,null, required)
    Type is one of the following: A, AAAA, ANAME, CNAME, MX, NS, SRV, or TXT.

## Response 429 fields (application/json):

  - `message` (string)
    A human-readable message providing more details about the error
    Example: "Rate Limit Exceeded"

## Response 500 fields (application/json):

  - `message` (string, required)
    A human-readable message providing more details about the error.
    Example: "Internal Server Error"

  - `details` (string,null)
    Additional context or information about the error.
    Example: "Something went wrong."