List Registrations

GET/accounts/{account_id}/registrar/registrations

Returns a paginated list of domain registrations owned by the account.

This endpoint uses cursor-based pagination. Results are ordered by registration date by default. To fetch the next page, pass the cursor value from the result_info object in the response as the cursor query parameter in your next request. An empty cursor string indicates there are no more pages.

Security

API Token

The preferred authorization scheme for interacting with the Cloudflare API. Create a token.

Example:Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY

API Email + API Key

The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key.

Example:X-Auth-Email: user@example.com

The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys.

Example:X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194

Path ParametersExpand Collapse

account_id: string

Identifier.

maxLength32

Query ParametersExpand Collapse

cursor: optional string

Opaque token from a previous response’s result_info.cursor. Pass this value to fetch the next page of results. Omit (or pass an empty string) for the first page.

maxLength256

direction: optional "asc" or "desc"

Sort direction for results. Defaults to ascending order.

One of the following:

"asc"

"desc"

per_page: optional number

Number of items to return per page.

maximum50

minimum1

sort_by: optional "registry_created_at" or "registry_expires_at" or "name"

Column to sort results by. Defaults to registration date (registry_created_at) when omitted.

One of the following:

"registry_created_at"

"registry_expires_at"

"name"

ReturnsExpand Collapse

errors: array of object { code, message, source }

code: number

minimum1000

message: string

source: optional object { pointer }

Location of the invalid value that caused the error.

pointer: string

JSON Pointer to the invalid or missing request value.

messages: array of object { code, message, source }

code: number

minimum1000

message: string

source: optional object { pointer }

Location of the invalid value that caused the error.

pointer: string

JSON Pointer to the invalid or missing request value.

result: array of Registration { auto_renew, created_at, domain_name, 4 more }

auto_renew: boolean

Whether automatic renewal occurs before expiration.

created_at: string

When the domain was registered. Present when the registration resource exists.

formatdate-time

domain_name: string

Provides a fully qualified domain name (FQDN), including the extension (e.g., example.com, mybrand.app). The domain name uniquely identifies a registration. Cloudflare permits only one registration per domain, making the domain name a natural idempotency key for registration requests.

expires_at: string

When the domain registration expires. Ready registrations include this value; only registration_pending may return null.

formatdate-time

locked: boolean

Whether the domain is locked for transfer.

privacy_mode: "off" or "redaction"

Current WHOIS privacy mode for the registration.

One of the following:

"off"

"redaction"

status: "active" or "registration_pending" or "expired" or 3 more

Current registration status.

active: The domain operates with an active registration.
registration_pending: Registration remains in progress.
expired: The domain registration expired.
suspended: The registry suspended the domain.
redemption_period: The domain entered the redemption grace period.
pending_delete: The registry scheduled the domain for deletion.

One of the following:

"active"

"registration_pending"

"expired"

"suspended"

"redemption_period"

"pending_delete"

result_info: object { count, cursor, per_page }

Provides cursor-based pagination metadata. List endpoints use this metadata for cursor pagination. Pass the cursor value as a query parameter in the next request to fetch the next page. An empty string indicates the end of pagination.

count: number

Number of items in the current result set.

cursor: string

Opaque cursor for fetching the next page. Pass this value as the cursor query parameter in a subsequent request. An empty string indicates the end of pagination.

per_page: number

Maximum number of items per page.

success: true

Whether the API call was successful.

List Registrations

curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/registrar/registrations \
    -H "Authorization: Bearer $CLOUDFLARE_API_TOKEN"

{
  "errors": [],
  "messages": [],
  "result": [],
  "result_info": {
    "count": 0,
    "cursor": "",
    "per_page": 20
  },
  "success": true
}

{
  "errors": [],
  "messages": [],
  "result": [
    {
      "auto_renew": true,
      "created_at": "2025-01-15T10:00:00Z",
      "domain_name": "example.com",
      "expires_at": "2026-01-15T10:00:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "active"
    },
    {
      "auto_renew": false,
      "created_at": "2025-03-20T14:30:00Z",
      "domain_name": "mybrand.dev",
      "expires_at": "2026-03-20T14:30:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "active"
    }
  ],
  "result_info": {
    "count": 2,
    "cursor": "",
    "per_page": 20
  },
  "success": true
}

{
  "errors": [],
  "messages": [],
  "result": [
    {
      "auto_renew": true,
      "created_at": "2025-04-01T09:00:00Z",
      "domain_name": "charlie.org",
      "expires_at": "2026-04-01T09:00:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "active"
    }
  ],
  "result_info": {
    "count": 1,
    "cursor": "",
    "per_page": 20
  },
  "success": true
}

{
  "errors": [],
  "messages": [],
  "result": [
    {
      "auto_renew": true,
      "created_at": "2024-01-15T09:30:00Z",
      "domain_name": "acmecorp.com",
      "expires_at": "2026-01-15T09:30:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "active"
    },
    {
      "auto_renew": true,
      "created_at": "2024-02-20T14:00:00Z",
      "domain_name": "brightwave.net",
      "expires_at": "2026-02-20T14:00:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "active"
    },
    {
      "auto_renew": true,
      "created_at": "2024-03-05T11:15:00Z",
      "domain_name": "cloudpeak.org",
      "expires_at": "2026-03-05T11:15:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "active"
    },
    {
      "auto_renew": true,
      "created_at": "2024-03-22T08:45:00Z",
      "domain_name": "solarpanel.io",
      "expires_at": "2026-03-22T08:45:00Z",
      "locked": true,
      "privacy_mode": "off",
      "status": "active"
    },
    {
      "auto_renew": false,
      "created_at": "2024-04-10T16:00:00Z",
      "domain_name": "greenleaf.dev",
      "expires_at": "2026-04-10T16:00:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "active"
    },
    {
      "auto_renew": true,
      "created_at": "2024-05-03T10:30:00Z",
      "domain_name": "swiftrunner.app",
      "expires_at": "2026-05-03T10:30:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "active"
    },
    {
      "auto_renew": false,
      "created_at": "2024-05-18T13:00:00Z",
      "domain_name": "northerntrail.co",
      "expires_at": "2025-05-18T13:00:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "expired"
    },
    {
      "auto_renew": true,
      "created_at": "2024-06-01T07:20:00Z",
      "domain_name": "pixelforge.xyz",
      "expires_at": "2026-06-01T07:20:00Z",
      "locked": false,
      "privacy_mode": "redaction",
      "status": "active"
    },
    {
      "auto_renew": true,
      "created_at": "2024-06-25T15:45:00Z",
      "domain_name": "oceandrift.com",
      "expires_at": "2026-06-25T15:45:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "active"
    },
    {
      "auto_renew": true,
      "created_at": "2024-07-12T09:00:00Z",
      "domain_name": "rocketlaunch.net",
      "expires_at": "2026-07-12T09:00:00Z",
      "locked": true,
      "privacy_mode": "off",
      "status": "active"
    },
    {
      "auto_renew": false,
      "created_at": "2024-08-08T12:30:00Z",
      "domain_name": "blueprintlab.io",
      "expires_at": "2026-08-08T12:30:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "active"
    },
    {
      "auto_renew": true,
      "created_at": "2024-09-01T18:00:00Z",
      "domain_name": "maplewood.org",
      "expires_at": "2026-09-01T18:00:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "active"
    },
    {
      "auto_renew": false,
      "created_at": "2024-09-20T10:15:00Z",
      "domain_name": "thunderbolt.dev",
      "expires_at": "2025-09-20T10:15:00Z",
      "locked": false,
      "privacy_mode": "off",
      "status": "expired"
    },
    {
      "auto_renew": true,
      "created_at": "2024-10-05T14:45:00Z",
      "domain_name": "silverbranch.app",
      "expires_at": "2026-10-05T14:45:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "active"
    },
    {
      "auto_renew": true,
      "created_at": "2024-11-11T08:00:00Z",
      "domain_name": "nightowl.co",
      "expires_at": "2026-11-11T08:00:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "active"
    },
    {
      "auto_renew": true,
      "created_at": "2024-12-01T11:30:00Z",
      "domain_name": "crimsongate.com",
      "expires_at": "2026-12-01T11:30:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "active"
    },
    {
      "auto_renew": false,
      "created_at": "2025-01-07T16:20:00Z",
      "domain_name": "frostedpine.net",
      "expires_at": "2027-01-07T16:20:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "active"
    },
    {
      "auto_renew": true,
      "created_at": "2025-01-25T09:50:00Z",
      "domain_name": "horizonline.xyz",
      "expires_at": "2027-01-25T09:50:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "active"
    },
    {
      "auto_renew": true,
      "created_at": "2025-02-14T13:00:00Z",
      "domain_name": "coppervine.io",
      "expires_at": "2027-02-14T13:00:00Z",
      "locked": true,
      "privacy_mode": "off",
      "status": "active"
    },
    {
      "auto_renew": true,
      "created_at": "2025-03-02T07:40:00Z",
      "domain_name": "starlitpath.org",
      "expires_at": "2027-03-02T07:40:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "active"
    }
  ],
  "result_info": {
    "count": 20,
    "cursor": "eyJ0IjoiMjAyNS0wNi0xNVQxMjowMDowMC4wMDAwMDBaIiwibiI6ImJyYXZvLm5ldCJ9",
    "per_page": 20
  },
  "success": true
}

{
  "errors": [
    {
      "code": 10000,
      "message": "Invalid pagination cursor"
    }
  ],
  "messages": [],
  "result": null,
  "success": false
}

Returns Examples

{
  "errors": [],
  "messages": [],
  "result": [],
  "result_info": {
    "count": 0,
    "cursor": "",
    "per_page": 20
  },
  "success": true
}

{
  "errors": [],
  "messages": [],
  "result": [
    {
      "auto_renew": true,
      "created_at": "2025-01-15T10:00:00Z",
      "domain_name": "example.com",
      "expires_at": "2026-01-15T10:00:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "active"
    },
    {
      "auto_renew": false,
      "created_at": "2025-03-20T14:30:00Z",
      "domain_name": "mybrand.dev",
      "expires_at": "2026-03-20T14:30:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "active"
    }
  ],
  "result_info": {
    "count": 2,
    "cursor": "",
    "per_page": 20
  },
  "success": true
}

{
  "errors": [],
  "messages": [],
  "result": [
    {
      "auto_renew": true,
      "created_at": "2025-04-01T09:00:00Z",
      "domain_name": "charlie.org",
      "expires_at": "2026-04-01T09:00:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "active"
    }
  ],
  "result_info": {
    "count": 1,
    "cursor": "",
    "per_page": 20
  },
  "success": true
}

{
  "errors": [],
  "messages": [],
  "result": [
    {
      "auto_renew": true,
      "created_at": "2024-01-15T09:30:00Z",
      "domain_name": "acmecorp.com",
      "expires_at": "2026-01-15T09:30:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "active"
    },
    {
      "auto_renew": true,
      "created_at": "2024-02-20T14:00:00Z",
      "domain_name": "brightwave.net",
      "expires_at": "2026-02-20T14:00:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "active"
    },
    {
      "auto_renew": true,
      "created_at": "2024-03-05T11:15:00Z",
      "domain_name": "cloudpeak.org",
      "expires_at": "2026-03-05T11:15:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "active"
    },
    {
      "auto_renew": true,
      "created_at": "2024-03-22T08:45:00Z",
      "domain_name": "solarpanel.io",
      "expires_at": "2026-03-22T08:45:00Z",
      "locked": true,
      "privacy_mode": "off",
      "status": "active"
    },
    {
      "auto_renew": false,
      "created_at": "2024-04-10T16:00:00Z",
      "domain_name": "greenleaf.dev",
      "expires_at": "2026-04-10T16:00:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "active"
    },
    {
      "auto_renew": true,
      "created_at": "2024-05-03T10:30:00Z",
      "domain_name": "swiftrunner.app",
      "expires_at": "2026-05-03T10:30:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "active"
    },
    {
      "auto_renew": false,
      "created_at": "2024-05-18T13:00:00Z",
      "domain_name": "northerntrail.co",
      "expires_at": "2025-05-18T13:00:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "expired"
    },
    {
      "auto_renew": true,
      "created_at": "2024-06-01T07:20:00Z",
      "domain_name": "pixelforge.xyz",
      "expires_at": "2026-06-01T07:20:00Z",
      "locked": false,
      "privacy_mode": "redaction",
      "status": "active"
    },
    {
      "auto_renew": true,
      "created_at": "2024-06-25T15:45:00Z",
      "domain_name": "oceandrift.com",
      "expires_at": "2026-06-25T15:45:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "active"
    },
    {
      "auto_renew": true,
      "created_at": "2024-07-12T09:00:00Z",
      "domain_name": "rocketlaunch.net",
      "expires_at": "2026-07-12T09:00:00Z",
      "locked": true,
      "privacy_mode": "off",
      "status": "active"
    },
    {
      "auto_renew": false,
      "created_at": "2024-08-08T12:30:00Z",
      "domain_name": "blueprintlab.io",
      "expires_at": "2026-08-08T12:30:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "active"
    },
    {
      "auto_renew": true,
      "created_at": "2024-09-01T18:00:00Z",
      "domain_name": "maplewood.org",
      "expires_at": "2026-09-01T18:00:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "active"
    },
    {
      "auto_renew": false,
      "created_at": "2024-09-20T10:15:00Z",
      "domain_name": "thunderbolt.dev",
      "expires_at": "2025-09-20T10:15:00Z",
      "locked": false,
      "privacy_mode": "off",
      "status": "expired"
    },
    {
      "auto_renew": true,
      "created_at": "2024-10-05T14:45:00Z",
      "domain_name": "silverbranch.app",
      "expires_at": "2026-10-05T14:45:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "active"
    },
    {
      "auto_renew": true,
      "created_at": "2024-11-11T08:00:00Z",
      "domain_name": "nightowl.co",
      "expires_at": "2026-11-11T08:00:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "active"
    },
    {
      "auto_renew": true,
      "created_at": "2024-12-01T11:30:00Z",
      "domain_name": "crimsongate.com",
      "expires_at": "2026-12-01T11:30:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "active"
    },
    {
      "auto_renew": false,
      "created_at": "2025-01-07T16:20:00Z",
      "domain_name": "frostedpine.net",
      "expires_at": "2027-01-07T16:20:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "active"
    },
    {
      "auto_renew": true,
      "created_at": "2025-01-25T09:50:00Z",
      "domain_name": "horizonline.xyz",
      "expires_at": "2027-01-25T09:50:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "active"
    },
    {
      "auto_renew": true,
      "created_at": "2025-02-14T13:00:00Z",
      "domain_name": "coppervine.io",
      "expires_at": "2027-02-14T13:00:00Z",
      "locked": true,
      "privacy_mode": "off",
      "status": "active"
    },
    {
      "auto_renew": true,
      "created_at": "2025-03-02T07:40:00Z",
      "domain_name": "starlitpath.org",
      "expires_at": "2027-03-02T07:40:00Z",
      "locked": true,
      "privacy_mode": "redaction",
      "status": "active"
    }
  ],
  "result_info": {
    "count": 20,
    "cursor": "eyJ0IjoiMjAyNS0wNi0xNVQxMjowMDowMC4wMDAwMDBaIiwibiI6ImJyYXZvLm5ldCJ9",
    "per_page": 20
  },
  "success": true
}

{
  "errors": [
    {
      "code": 10000,
      "message": "Invalid pagination cursor"
    }
  ],
  "messages": [],
  "result": null,
  "success": false
}