--- title: List domains --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api) [Registrar](https://developers.cloudflare.com/api/resources/registrar) [Domains](https://developers.cloudflare.com/api/resources/registrar/subresources/domains) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # List domains Deprecated: This operation is deprecated and will reach end of life on September 27, 2026. Use the new Registrar API endpoints (domain-search, domain-check, registrations) instead. Refer to https://developers.cloudflare.com/fundamentals/api/reference/deprecations/ for details. GET/accounts/{account\_id}/registrar/domains Lists domains handled by Registrar. ##### 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.domains%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20account_id%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.domains%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.domains%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20messages>)
result: array of Domain { id, available, can\_register, 9 more } id: optional string Domain identifier. maxLength32 Link to this property available: optional boolean Shows if a domain is available for transferring into Cloudflare Registrar. Link to this property can\_register: optional boolean Indicates eligibility to register the domain as a new domain. Link to this property created\_at: optional string Shows time of creation. formatdate-time Link to this property current\_registrar: optional string Shows name of current registrar. Link to this property expires\_at: optional string Shows when domain name registration expires. formatdate-time Link to this property locked: optional boolean Shows whether a registrar lock is in place for a domain. Link to this property
registrant\_contact: optional object {address, city, country, 10 more } Shows contact information for domain registrant. address: string Address. Link to this property city: string City. Link to this property country: string The country in which the user lives. maxLength30 Link to this property first\_name: string User’s first name. maxLength60 Link to this property last\_name: string User’s last name. maxLength60 Link to this property organization: string Name of organization. Link to this property phone: string User’s telephone number. maxLength20 Link to this property state: string State. Link to this property zip: string The zipcode or postal code where the user lives. maxLength20 Link to this property id: optional string Contact Identifier. maxLength32 Link to this property address2: optional string Optional address line for unit, floor, suite, etc. Link to this property email: optional string The contact email address of the user. maxLength90 Link to this property fax: optional string Contact fax number. Link to this property
Link to this property registry\_statuses: optional string A comma-separated list of registry status codes. Refer to EPP Status Codes for the full list. Link to this property supported\_tld: optional boolean Indicates whether Cloudflare Registrar currently supports a particular TLD. Refer to TLD Policies for a list of supported TLDs. Link to this property
transfer\_in: optional object {accept\_foa, approve\_transfer, can\_cancel\_transfer, 3 more } Statuses for domain transfers into Cloudflare Registrar.
accept\_foa: optional "needed"or "ok" Status of the registrant authorization step. One of the following: "needed" Link to this property "ok" Link to this property
Link to this property
approve\_transfer: optional "needed"or "ok"or "pending"or 3 more Status of the registry transfer-approval step. One of the following: "needed" Link to this property "ok" Link to this property "pending" Link to this property "trying" Link to this property "rejected" Link to this property "unknown" Link to this property
Link to this property can\_cancel\_transfer: optional boolean Indicates if cancellation is still possible. Link to this property
disable\_privacy: optional "needed"or "ok"or "unknown" Status of the privacy-guard disabling step at the foreign registrar. One of the following: "needed" Link to this property "ok" Link to this property "unknown" Link to this property
Link to this property
enter\_auth\_code: optional "needed"or "ok"or "pending"or 2 more Status of the auth-code entry and verification step. One of the following: "needed" Link to this property "ok" Link to this property "pending" Link to this property "trying" Link to this property "rejected" Link to this property
Link to this property
unlock\_domain: optional "needed"or "ok"or "pending"or 2 more Status of the domain-unlock step at the foreign registrar. One of the following: "needed" Link to this property "ok" Link to this property "pending" Link to this property "trying" Link to this property "unknown" Link to this property
Link to this property
Link to this property updated\_at: optional string Last updated. formatdate-time Link to this property
[Link to this property](<#(resource)%20registrar.domains%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20result>) success: true Whether the API call was successful. [Link to this property](<#(resource)%20registrar.domains%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20success>)
result\_info: optional object {count, page, per\_page, total\_count } count: optional number Total number of results for the requested service. Link to this property page: optional number Current page within paginated list of results. Link to this property per\_page: optional number Number of results per page of results. Link to this property total\_count: optional number Total results available without any search parameters. Link to this property
[Link to this property](<#(resource)%20registrar.domains%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20result_info>) ### List domains HTTP HTTPTypeScriptPythonGoTerraform ``` curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/registrar/domains \ -H "Authorization: Bearer $CLOUDFLARE_API_TOKEN" ``` 200 example ``` { "errors": [ { "code": 1000, "message": "message", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "source": { "pointer": "pointer" } } ], "result": [ { "id": "ea95132c15732412d22c1476fa83f27a", "available": false, "can_register": false, "created_at": "2018-08-28T17:26:26Z", "current_registrar": "Cloudflare", "expires_at": "2019-08-28T23:59:59Z", "locked": false, "registrant_contact": { "address": "123 Sesame St.", "city": "Austin", "country": "US", "first_name": "John", "last_name": "Appleseed", "organization": "Cloudflare, Inc.", "phone": "+1 123-123-1234", "state": "TX", "zip": "12345", "id": "ea95132c15732412d22c1476fa83f27a", "address2": "Suite 430", "email": "user@example.com", "fax": "123-867-5309" }, "registry_statuses": "ok,serverTransferProhibited", "supported_tld": true, "transfer_in": { "accept_foa": "needed", "approve_transfer": "unknown", "can_cancel_transfer": true, "disable_privacy": "ok", "enter_auth_code": "needed", "unlock_domain": "ok" }, "updated_at": "2018-08-28T17:26:26Z" } ], "success": true, "result_info": { "count": 1, "page": 1, "per_page": 20, "total_count": 2000 } } ``` ##### Returns Examples 200 example ``` { "errors": [ { "code": 1000, "message": "message", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "source": { "pointer": "pointer" } } ], "result": [ { "id": "ea95132c15732412d22c1476fa83f27a", "available": false, "can_register": false, "created_at": "2018-08-28T17:26:26Z", "current_registrar": "Cloudflare", "expires_at": "2019-08-28T23:59:59Z", "locked": false, "registrant_contact": { "address": "123 Sesame St.", "city": "Austin", "country": "US", "first_name": "John", "last_name": "Appleseed", "organization": "Cloudflare, Inc.", "phone": "+1 123-123-1234", "state": "TX", "zip": "12345", "id": "ea95132c15732412d22c1476fa83f27a", "address2": "Suite 430", "email": "user@example.com", "fax": "123-867-5309" }, "registry_statuses": "ok,serverTransferProhibited", "supported_tld": true, "transfer_in": { "accept_foa": "needed", "approve_transfer": "unknown", "can_cancel_transfer": true, "disable_privacy": "ok", "enter_auth_code": "needed", "unlock_domain": "ok" }, "updated_at": "2018-08-28T17:26:26Z" } ], "success": true, "result_info": { "count": 1, "page": 1, "per_page": 20, "total_count": 2000 } } ```