---
title: "Fetch every DNS record type for a domain in one call"
method: POST
path: "/api/v1/domain/dns-records"
tags: ["Domain"]
---

# Fetch every DNS record type for a domain in one call

`POST /api/v1/domain/dns-records`

## Request

- Base URL: `https://firstsales.io`
- URL: `https://firstsales.io/api/v1/domain/dns-records`
- Auth: none required

Queries A, AAAA, MX, NS, TXT, SOA, and CNAME records in parallel and returns them flattened, with a per-type summary count. Use this for a full DNS snapshot instead of calling dns/check once per record type. Rate limit: 10 requests/minute per IP.

## Request body

- object
  - `domain` string, required

## Response `200`

All discovered DNS records for the domain.

- DnsRecordsResult
  - `domain` string, required
  - `records` object[], required
    - `type` 'A' | 'AAAA' | 'MX' | 'NS' | 'TXT' | 'SOA' | 'CNAME', required
    - `value` string, required
    - `priority` number
    - `ttl` number
  - `summary` object, required: Count of records per type, e.g. { A: 1, MX: 2 }.
  - `totalRecords` number, required

## Other responses

- `400`: Invalid request — bad input, missing field, or malformed value.
- `404`: Domain does not exist or has no DNS records.
- `429`: Rate limit exceeded for this endpoint. Wait Retry-After seconds and retry.
- `500`: Unexpected server error.

---

[API](https://skmtc.dev/firstsales/apis/firstsales-public-api.md) · [All operations](https://skmtc.dev/firstsales/apis/firstsales-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/firstsales/apis/firstsales-public-api/revisions/3856191adf12?raw)