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 |