---
title: "Lists the records of a specific primary domain."
method: GET
path: "/domains/primary/{domainId}/records"
tags: ["records - primary"]
---

# Lists the records of a specific primary domain.

`GET /domains/primary/{domainId}/records`

## Request

- Base URL: `https://manager.digicertdns.com/v1`
- URL: `https://manager.digicertdns.com/v1/domains/primary/{domainId}/records`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/digicert/apis/digicert-dns/docs/domains/primary/:domainId/records/get.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint lists the records of a specific primary domain, helping users manage and review the domain's configuration.</br></br>Key features include:</br></br>- **Clear success messaging:** Returns a `200` success code with a confirmation message indicating the successful completion of the requested action.</br>- **Comprehensive error handling:** Returns `400`, `401`, and `404` error codes with clear descriptions when requests fail.</br>- **Controlled data limits:** The `pageSize` parameter allows users to define the maximum number of records to display per page, optimizing data retrieval for specific use cases.</br>- **Customizable pagination:** The `pageNumber` parameter allows users to specify the page of results they wish to retrieve, ensuring targeted access to data.</br>- **Dynamic filtering:** Uses the `type` parameter to filter results, streamlining access to specific records and enhancing data retrieval efficiency.</br>- **Efficient sorting:** The `sortBy` parameter enables users to organize responses by various attributes, offering flexibility in result management.</br>- **Geographical filtering:** Uses the `gtdLocation` parameter to filter results, allowing users to focus on region-specific data.</br>- **Targeted data retrieval:** Employs the `domainId` parameter to return the specified domain's records, ensuring accuracy and relevance in the response.

## Path parameters

- `domainId` integer, required

## Query parameters

- `pageSize` integer
- `pageNumber` integer
- `sortBy` 'gtdLocationAsc' | 'gtdLocationDesc' | 'nameDesc' | 'typeAsc' | 'typeDesc' | 'modifiedTsAsc' | 'modifiedTsDesc' | 'createdTsAsc' | 'createdTsDesc'
- `type` 'A' | 'AAAA'
- `gtdLocation` 'DEFAULT' | 'NA_WEST' | 'NA_EAST' | 'SOUTH_AMERICA' | 'EUROPE' | 'AFRICA' | 'ASIA_PAC' | 'OCEANIA'

## Response `200`

DNS records returned successfully.

- InlineResponse200
  - `data` ARecordLegacy[]
    - `id` integer
    - `name` string
    - `type` string
    - `value` string[]
    - `dynamicFlag` boolean
    - `ttl` integer
    - `monitorFlag` boolean
    - `dnsfoFlag` boolean
    - `source` string
    - `createdTs` string
    - `modifiedTs` string
  - `total` integer
  - `count` integer
  - `perPage` integer
  - `currentPage` integer
  - `totalPages` integer

## Other responses

- `400`: Request is malformed or invalid.
- `401`: Token is missing or expired.
- `404`: Resource not found.

---

[API](https://skmtc.dev/digicert/apis/digicert-dns.md) - [All operations](https://skmtc.dev/digicert/apis/digicert-dns/llms.txt) - [OpenAPI document](https://skmtc.dev/digicert/apis/digicert-dns/revisions/c74fc728cff8?raw)