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

© UK DNS Privacy Project Ltd 2024, All rights reserved.

A company limited by guarantee, registered in England and Wales. Company Number: 16203731.

Registered Office: 71-75 Shelton Street, Covent Garden, London. WC2H 9JQ.

We operate for the public benefit, with no shareholders or profit-driven motives.

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.