API REFERENCE

List own domains, including archived

GET/api/v1/domains

Operates on your account only. Send your API key in the Authorization header. Responses use JSON.

Request

Set BASE_URL to this website’s HTTPS origin and API_KEY to your private key. Replace RESOURCE_ID with the ID returned by the API.

cURL

curl --request GET "${BASE_URL}/api/v1/domains" \
  --header "Authorization: Bearer $API_KEY"

Headers & parameters

Authorizationrequired

Bearer YOUR_API_KEY

limitquery · integer

Page size, not a request quota.

1–100

offsetquery · integer

Number of items to skip.

0–100000

Response

202 means accepted, not completed. Poll the order or operation. If the outcome is unknown, do not issue another purchase. Amounts are decimal strings in USD; dates use ISO 8601.

request_idstringrequired

Identifier used to recover an outcome after a network failure.

itemsarrayrequired

items[].idintegerrequired

items[].namestringrequired

@ for the apex, * for wildcard, or a record name.

items[].categorystring

Pricing category: basic or protected.

items[].expires_atstring | null

items[].autorenewboolean

items[].archivedboolean

items[].nameserversarray

Nameserver hostnames, not IP addresses.

items[].dns_backendstring

items[].delegationstring

items[].renewal_periodsarray

items[].cloudflareobjectrequired

items[].cloudflare.connectedboolean

items[].cloudflare.statusstring

Current state. An accepted job does not mean completion.

items[].cloudflare.ssl_statusstring

Cloudflare visitor-facing certificate state.

items[].cloudflare.origin_tls_statusstring

Separate HTTPS state between Cloudflare and the origin server.

items[].cloudflare.nameserversarray

Nameserver hostnames, not IP addresses.

items[].cloudflare.checked_atstring | null

items[].cloudflare.settingsobject

items[].cloudflare.geo_countriesarray

items[].cloudflare.available_settingsobject

totalintegerrequired

next_offsetinteger | nullrequired

Next page offset; null means the end of the list.

Response structure example · illustrative values

JSON

{
  "request_id": "00000000-0000-4000-8000-000000000001",
  "items": [
    {
      "id": 1,
      "name": "example.com",
      "category": "string",
      "expires_at": "2026-10-02T12:00:00Z",
      "autorenew": false,
      "archived": false,
      "nameservers": [
        "string"
      ],
      "dns_backend": "string",
      "delegation": "string",
      "renewal_periods": [
        1
      ],
      "cloudflare": {
        "connected": false,
        "status": "string",
        "ssl_status": "string",
        "origin_tls_status": "string",
        "nameservers": [
          "string"
        ],
        "checked_at": "2026-10-02T12:00:00Z",
        "settings": {},
        "geo_countries": [
          "string"
        ],
        "available_settings": {}
      }
    }
  ],
  "total": 1,
  "next_offset": 1
}

Errors & statuses

error.code · error.message · request_id

401

Invalid or revoked key.

404

Resource not found in your account.

409

Idempotency conflict or request in progress.

422

Invalid parameters or business rule, including balance.

500

Outcome may be uncertain. Poll the request.

503

Temporarily unavailable. Respect Retry-After.