List DNS domains

GET/v1/dns/domains

A GET request to the /v1/dns/domains endpoint will show a list of your DNS domains. You can make the request more specific using the query parameters.

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Query Parameters

FieldDetails
search_pattern?
string

This pattern is used to return resources containing the parameter value in its name.

label_selector?
string

This parameter will filter results by labels. More details in the Labels section.

delegation_status?
string

Value in: "delegated", "verified", "undelegated"

There are three domain delegation statuses:

  • undelegated - the domain hasn't been delegated or verified, or has lost delegation and verification;
  • verified - the domain isn't delegated but has a valid TXT verification record;
  • delegated - the domain's NS records point to the Servers.com name servers and at least one of them responds authoritatively.
per_page?
integer

Default: 20

Range: 1–100

The number of results [ 1 .. 100 ] displayed on a page. By default, 20 results are shown.

page?
integer

Default: 1

Min: 1

The number of a page (>= 1) that will be returned. By default, it's 1.

sorting?
string

Value in: "id", "name", "delegation_status", "created_at", "updated_at"

Default: "id"

This parameter sorts items. By default, it's id. Also, it's possible to sort by name, updated_at and created_at.

direction?
string

Value in: "ASC", "DESC"

Default: "ASC"

This parameter defines if items are sorted in an ascending ASC or descending DESC order. By default, ASC is set up.

Response Body

application/json

application/json

curl -X GET "https://example.com/v1/dns/domains?label_selector=environment%3Dproduction"
[  {    "id": "open5Rd7",    "name": "example-595.com",    "email": "person-45@example.com",    "ttl": 3600,    "delegation_status": "delegated",    "unpublish_date": null,    "labels": {      "environment": "production"    },    "updated_at": "2025-12-31T00:00:00Z",    "created_at": "2025-12-31T00:00:00Z"  }]