--- title: List domains --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [Registrar](https://developers.cloudflare.com/api/python/resources/registrar) [Domains](https://developers.cloudflare.com/api/python/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. registrar.domains.list(DomainListParams\*\*kwargs) -> SyncSinglePage\[[Domain]()] 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
##### ParametersExpand Collapse account\_id: str 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
class Domain: … id: Optional\[str] Domain identifier. maxLength32 Link to this property available: Optional\[bool] Shows if a domain is available for transferring into Cloudflare Registrar. Link to this property can\_register: Optional\[bool] Indicates eligibility to register the domain as a new domain. Link to this property created\_at: Optional\[datetime] Shows time of creation. formatdate-time Link to this property current\_registrar: Optional\[str] Shows name of current registrar. Link to this property expires\_at: Optional\[datetime] Shows when domain name registration expires. formatdate-time Link to this property locked: Optional\[bool] Shows whether a registrar lock is in place for a domain. Link to this property
registrant\_contact: Optional\[RegistrantContact] Shows contact information for domain registrant. address: str Address. Link to this property city: str City. Link to this property country: Optional\[str] The country in which the user lives. maxLength30 Link to this property first\_name: Optional\[str] User’s first name. maxLength60 Link to this property last\_name: Optional\[str] User’s last name. maxLength60 Link to this property organization: str Name of organization. Link to this property phone: Optional\[str] User’s telephone number. maxLength20 Link to this property state: str State. Link to this property zip: Optional\[str] The zipcode or postal code where the user lives. maxLength20 Link to this property id: Optional\[str] Contact Identifier. maxLength32 Link to this property address2: Optional\[str] Optional address line for unit, floor, suite, etc. Link to this property email: Optional\[str] The contact email address of the user. maxLength90 Link to this property fax: Optional\[str] Contact fax number. Link to this property
Link to this property registry\_statuses: Optional\[str] A comma-separated list of registry status codes. Refer to EPP Status Codes for the full list. Link to this property supported\_tld: Optional\[bool] 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\[TransferIn] Statuses for domain transfers into Cloudflare Registrar.
accept\_foa: Optional\[Literal\["needed", "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\[Literal\["needed", "ok", "pending", 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\[bool] Indicates if cancellation is still possible. Link to this property
disable\_privacy: Optional\[Literal\["needed", "ok", "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\[Literal\["needed", "ok", "pending", 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\[Literal\["needed", "ok", "pending", 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\[datetime] Last updated. formatdate-time Link to this property
[Link to this property](<#(resource)%20registrar.domains%20%3E%20(model)%20domain%20%3E%20(schema)>) ### List domains Python HTTPTypeScriptPythonGoTerraform ``` 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.domains.list( account_id="023e105f4ecef8ad9ca31a8372d0c353", ) page = page.result[0] print(page.id) ``` 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 } } ```