List Registrations

registrar.registrations.list() -> SyncCursorPagination[Registration]

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

ParametersExpand Collapse

account_id: str

Identifier.

maxLength32

cursor: Optional[str]

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[Literal["asc", "desc"]]

Sort direction for results. Defaults to ascending order.

One of the following:

"asc"

"desc"

per_page: Optional[int]

Number of items to return per page.

maximum50

minimum1

sort_by: Optional[Literal["registry_created_at", "registry_expires_at", "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

class Registration: …

A domain registration resource representing the current state of a registered domain.

auto_renew: bool

Whether automatic renewal occurs before expiration.

created_at: datetime

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

formatdate-time

domain_name: str

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: Optional[datetime]

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

formatdate-time

locked: bool

Whether the domain is locked for transfer.

privacy_mode: Literal["off", "redaction"]

Current WHOIS privacy mode for the registration.

One of the following:

"off"

"redaction"

status: Literal["active", "registration_pending", "expired", 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"

List Registrations

import os
from cloudflare import Cloudflare

client = Cloudflare(
    api_token=os.environ.get("CLOUDFLARE_API_TOKEN"),  # This is the default and can be omitted
)
page = client.registrar.registrations.list(
    account_id="023e105f4ecef8ad9ca31a8372d0c353",
)
page = page.result[0]
print(page.auto_renew)

{
  "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
}