Sidebar

List Records API

GET /domains/:domain_name/records

List DNS records for a specific domain.

Path Parameters

Name Type Description
domain_name string Domain name (e.g. example.com)

Query Parameters

Name Type Description
name string Partial name to filter records by
record_type string Type of record to filter by
sort string Field to sort by (e.g., name)
sort_direction string Sort direction (asc or desc)

Authentication

Requires Bearer token or API key in query string.

Example Request

curl -X GET "https://dnsprivacy.org.uk/domains/example.com/records?record_type=A" \
  -H "Authorization: Bearer <your-access-token>" \
  -H "accept: application/json"

Response (200 OK)

[
  {
    "id": 1,
    "name": "www",
    "record_type": "A",
    "content": "192.0.2.1",
    "ttl": "3600",
    "fqdn": "www.example.com"
  }
]

Response Schema

Field Type Description
id integer Unique identifier for the record
name string Name/label for the DNS record
record_type string DNS record type (e.g., A, AAAA, TXT)
content string Value or target of the record
ttl string Time to live (in seconds)
fqdn string Fully qualified domain name

Our use of cookies
We use a session cookie to maintain your login state when you create an account with us. This cookie is essential for the operation of our website and is used solely for authentication purposes. For more information, please read our privacy policy.