Sidebar

List Domains API

GET /domains

Returns a list of domains.

Query Parameters

Name Type Description
page integer Page number
sort string Field to sort by (e.g., name)
sort_direction string Sort direction (asc or desc)
apikey string Your API key

Authentication

This endpoint requires authentication via Bearer token or API key in query string.


Example Request

curl -X GET "https://dnsprivacy.org.uk/domains" \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer <your-access-token>'

Example Response

[
  {
    "name": "example.com",
    "delegated": false,
    "created_at": "1970-01-01T00:00:00.000Z",
    "updated_at": "1970-01-01T00:00:00.000Z",
    "serial_number": 2025043001,
    "refresh_interval": 3600,
    "retry_interval": 600,
    "expire_interval": 604800,
    "minimum_ttl": 300,
    "dnssec_enabled": true
  }
]

Response Schema

Field Type Description
name string Domain name
delegated boolean Whether the domain is delegated
created_at date-time When the domain was created
updated_at date-time When the domain was last updated
serial_number integer SOA serial number
refresh_interval integer SOA refresh value (seconds)
retry_interval integer SOA retry value (seconds)
expire_interval integer SOA expire value (seconds)
minimum_ttl integer SOA minimum TTL (seconds)
dnssec_enabled boolean Whether DNSSEC is enabled

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.