# GET /api/v1/dns/records

> List the DNS records of a zone

- Group: dns
- Tier: R
- Required scope: read:dns
- Docs: https://api.inleed.com/reference/dns/list-dns-records

## Description

Returns `data[]` of records — `id`, `type`, `name`, `value`, `ttl` (and `priority` for MX) — for the resolved domain, plus the `target`.

## Query parameters

- `input` — string (required). A domain, email address, website URL, or Inleed service id — for example example.se, info@example.se or 42976. Resolved to the owning account automatically, and the resolved target is echoed back in the response. Up to 255 characters.
- `type` — enum. Optional: return only records of this type. One of A, AAAA, CNAME, MX, TXT, NS, SRV, CAA.
- `limit` — integer. Page size for a collection. Range 1–200.

## Request

```bash
curl -X GET "https://mcp.inleed.com/api/v1/dns/records?input=example.se&type=A&limit=3" \
  -H "Authorization: Bearer inl_live_…"
```

## Errors

- **400**  — codes: invalid_request
- **401** No token was presented, or the token is revoked, expired or unknown. — codes: unauthorized, token_expired, token_revoked
- **403** The token lacks a required scope, or this account does not own the resource. — codes: insufficient_scope, domain_not_owned
- **404** No such resource for this account. — codes: not_found, record_not_found
- **422** Validation error — codes: validation_failed
- **429** The rate limit for this token is exhausted. See `Retry-After`. — codes: rate_limited
- **500** Something went wrong on our side. The failure is logged against `requestId`. — codes: internal_error

## Related

- POST /api/v1/dns/records — https://api.inleed.com/reference/dns/create-dns-record
- PUT /api/v1/dns/records — https://api.inleed.com/reference/dns/update-dns-record
- DELETE /api/v1/dns/records — https://api.inleed.com/reference/dns/delete-dns-record