---
title: List Registrations
---
[Skip to content](#_top)
[API Reference](https://developers.cloudflare.com/api)
[Registrar](https://developers.cloudflare.com/api/resources/registrar)
[Registrations](https://developers.cloudflare.com/api/resources/registrar/subresources/registrations)
Copy Markdown
Open in **Claude**Open in **ChatGPT**Open in **Cursor**
---
**Copy Markdown****View as Markdown**
# 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
##### P ath ParametersExpand Collapse
account\_id: string
Identifier.
maxLength32
[Link to this property](<#(resource)%20registrar.registrations%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20account_id%20%3E%20(schema)>)
##### Q uery 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
[Link to this property](<#(resource)%20registrar.registrations%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20cursor%20%3E%20(schema)>)
direction: optional "asc"or "desc"
Sort direction for results. Defaults to ascending order.
One of the following:
"asc"
Link to this property
"desc"
Link to this property
[Link to this property](<#(resource)%20registrar.registrations%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20direction%20%3E%20(schema)>)
per\_page: optional number
Number of items to return per page.
maximum50
minimum1
[Link to this property](<#(resource)%20registrar.registrations%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20per_page%20%3E%20(schema)>)
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"
Link to this property
"registry\_expires\_at"
Link to this property
"name"
Link to this property
[Link to this property](<#(resource)%20registrar.registrations%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20sort_by%20%3E%20(schema)>)
##### ReturnsExpand Collapse
errors: array of object {code, message, source }
code: number
minimum1000
Link to this property
message: string
Link to this property
source: optional object {pointer }
Location of the invalid value that caused the error.
pointer: string
JSON Pointer to the invalid or missing request value.
Link to this property
Link to this property
[Link to this property](<#(resource)%20registrar.registrations%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20errors>)
messages: array of object {code, message, source }
code: number
minimum1000
Link to this property
message: string
Link to this property
source: optional object {pointer }
Location of the invalid value that caused the error.
pointer: string
JSON Pointer to the invalid or missing request value.
Link to this property
Link to this property
[Link to this property](<#(resource)%20registrar.registrations%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20messages>)
result: array of Registration { auto\_renew, created\_at, domain\_name, 4 more }
auto\_renew: boolean
Whether automatic renewal occurs before expiration.
Link to this property
created\_at: string
When the domain was registered. Present when the registration resource exists.
formatdate-time
Link to this property
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.
Link to this property
expires\_at: string
When the domain registration expires. Ready registrations include this value; only registration_pending and transfer_pending may return null.
formatdate-time
Link to this property
locked: boolean
Whether the domain is locked for transfer.
Link to this property
privacy\_mode: "off"or "redaction"
Current WHOIS privacy mode for the registration.
One of the following:
"off"
Link to this property
"redaction"
Link to this property
Link to this property
status: "active"or "registration\_pending"or "transfer\_pending"or 4 more
Current registration status.
- active: The domain operates with an active registration.
- registration_pending: Registration remains in progress.
- transfer_pending: Domain transfer is 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"
Link to this property
"registration\_pending"
Link to this property
"transfer\_pending"
Link to this property
"expired"
Link to this property
"suspended"
Link to this property
"redemption\_period"
Link to this property
"pending\_delete"
Link to this property
Link to this property
[Link to this property](<#(resource)%20registrar.registrations%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20result>)
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.
Link to this property
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.
Link to this property
per\_page: number
Maximum number of items per page.
Link to this property
[Link to this property](<#(resource)%20registrar.registrations%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20result_info>)
success: true
Whether the API call was successful.
[Link to this property](<#(resource)%20registrar.registrations%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20success>)
### List Registrations
HTTP
HTTPTypeScriptPythonGoTerraform
```
curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/registrar/registrations \
-H "Authorization: Bearer $CLOUDFLARE_API_TOKEN"
```
200 example
200 example
200 example
200 example
4XX example
```
{
"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
200 example
200 example
200 example
200 example
4XX example
```
{
"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
}
```