--- title: Get Registration --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api) [Registrar Sandbox](https://developers.cloudflare.com/api/resources/registrar_sandbox) [Registrations](https://developers.cloudflare.com/api/resources/registrar_sandbox/subresources/registrations) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Get Registration GET/accounts/{account\_id}/registrar-sandbox/registrations/{domain\_name} Returns the current state of a domain registration. This is the canonical read endpoint for a domain you own. It returns the full registration resource including current settings and expiration. When the registration resource is ready, both `created_at` and `expires_at` are present in the response. ##### 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_sandbox.registrations%20%3E%20(method)%20get%20%3E%20(params)%20default%20%3E%20(param)%20account_id%20%3E%20(schema)>) 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](<#(resource)%20registrar_sandbox.registrations%20%3E%20(method)%20get%20%3E%20(params)%20default%20%3E%20(param)%20domain_name%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_sandbox.registrations%20%3E%20(method)%20get%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_sandbox.registrations%20%3E%20(method)%20get%20%3E%20(network%20schema)%20%3E%20(property)%20messages>)

result: object {auto\_renew, created\_at, domain\_name, 4 more } A domain registration resource representing the current state of a registered domain.

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_sandbox.registrations%20%3E%20(method)%20get%20%3E%20(network%20schema)%20%3E%20(property)%20result>) success: true Whether the API call was successful. [Link to this property](<#(resource)%20registrar_sandbox.registrations%20%3E%20(method)%20get%20%3E%20(network%20schema)%20%3E%20(property)%20success>) ### Get Registration HTTP HTTPTypeScriptPythonGoTerraform ``` curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/registrar-sandbox/registrations/$DOMAIN_NAME \ -H "Authorization: Bearer $CLOUDFLARE_API_TOKEN" ``` 200 example 4XX example 4XX example ``` { "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" }, "success": true } ``` ``` { "errors": [ { "code": 10000, "message": "Domain not found" } ], "messages": [], "result": null, "success": false } ``` ``` { "errors": [ { "code": 10000, "message": "Invalid domain name" } ], "messages": [], "result": null, "success": false } ``` ##### Returns Examples 200 example 4XX example 4XX example ``` { "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" }, "success": true } ``` ``` { "errors": [ { "code": 10000, "message": "Domain not found" } ], "messages": [], "result": null, "success": false } ``` ``` { "errors": [ { "code": 10000, "message": "Invalid domain name" } ], "messages": [], "result": null, "success": false } ```