List domains

GET

/domains

List all domains for the authenticated customer. Domain statuses: QUEUED | PENDING_NS | ACTIVE | FAILED

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

Responses

🟢200

application/json

Paginated list of domains

Body

🟠401

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET '/domains?status&page&limit' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Success

{
    "success": true,
    "data": [
        {
            "id": "dom_abc123",
            "domain": "yourdomain.com",
            "status": "ACTIVE",
            "ns1": "aspen.ns.cloudflare.com",
            "ns2": "kobe.ns.cloudflare.com",
            "batchNumber": 1,
            "createdAt": "2026-03-01T10:00:00.000Z"
        }
    ],
    "meta": {
        "page": 1,
        "limit": 20,
        "total": 1
    }
}

Modified at 2026-03-12 08:23:25

Submit domains

Get domain