--- title: List domains --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/go) [Registrar](https://developers.cloudflare.com/api/go/resources/registrar) [Domains](https://developers.cloudflare.com/api/go/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. client.Registrar.Domains.List(ctx, query) (\*SinglePage\[[Domain]()], error) 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
query DomainListParams AccountID param.Field\[string] Identifier. maxLength32 Link to this property
[Link to this property](<#(resource)%20registrar.domains%20%3E%20(method)%20list%20%3E%20(params)%20default>) ##### ReturnsExpand Collapse
type Domain struct{…} ID stringOptional Domain identifier. maxLength32 Link to this property Available boolOptional Shows if a domain is available for transferring into Cloudflare Registrar. Link to this property CanRegister boolOptional Indicates eligibility to register the domain as a new domain. Link to this property CreatedAt TimeOptional Shows time of creation. formatdate-time Link to this property CurrentRegistrar stringOptional Shows name of current registrar. Link to this property ExpiresAt TimeOptional Shows when domain name registration expires. formatdate-time Link to this property Locked boolOptional Shows whether a registrar lock is in place for a domain. Link to this property
RegistrantContact DomainRegistrantContactOptional 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 FirstName string User’s first name. maxLength60 Link to this property LastName 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 stringOptional Contact Identifier. maxLength32 Link to this property Address2 stringOptional Optional address line for unit, floor, suite, etc. Link to this property Email stringOptional The contact email address of the user. maxLength90 Link to this property Fax stringOptional Contact fax number. Link to this property
Link to this property RegistryStatuses stringOptional A comma-separated list of registry status codes. Refer to EPP Status Codes for the full list. Link to this property SupportedTLD boolOptional Indicates whether Cloudflare Registrar currently supports a particular TLD. Refer to TLD Policies for a list of supported TLDs. Link to this property
TransferIn DomainTransferInOptional Statuses for domain transfers into Cloudflare Registrar.
AcceptFoa DomainTransferInAcceptFoaOptional Status of the registrant authorization step. One of the following: const DomainTransferInAcceptFoaNeeded DomainTransferInAcceptFoa = "needed" Link to this property const DomainTransferInAcceptFoaOk DomainTransferInAcceptFoa = "ok" Link to this property
Link to this property
ApproveTransfer DomainTransferInApproveTransferOptional Status of the registry transfer-approval step. One of the following: const DomainTransferInApproveTransferNeeded DomainTransferInApproveTransfer = "needed" Link to this property const DomainTransferInApproveTransferOk DomainTransferInApproveTransfer = "ok" Link to this property const DomainTransferInApproveTransferPending DomainTransferInApproveTransfer = "pending" Link to this property const DomainTransferInApproveTransferTrying DomainTransferInApproveTransfer = "trying" Link to this property const DomainTransferInApproveTransferRejected DomainTransferInApproveTransfer = "rejected" Link to this property const DomainTransferInApproveTransferUnknown DomainTransferInApproveTransfer = "unknown" Link to this property
Link to this property CanCancelTransfer boolOptional Indicates if cancellation is still possible. Link to this property
DisablePrivacy DomainTransferInDisablePrivacyOptional Status of the privacy-guard disabling step at the foreign registrar. One of the following: const DomainTransferInDisablePrivacyNeeded DomainTransferInDisablePrivacy = "needed" Link to this property const DomainTransferInDisablePrivacyOk DomainTransferInDisablePrivacy = "ok" Link to this property const DomainTransferInDisablePrivacyUnknown DomainTransferInDisablePrivacy = "unknown" Link to this property
Link to this property
EnterAuthCode DomainTransferInEnterAuthCodeOptional Status of the auth-code entry and verification step. One of the following: const DomainTransferInEnterAuthCodeNeeded DomainTransferInEnterAuthCode = "needed" Link to this property const DomainTransferInEnterAuthCodeOk DomainTransferInEnterAuthCode = "ok" Link to this property const DomainTransferInEnterAuthCodePending DomainTransferInEnterAuthCode = "pending" Link to this property const DomainTransferInEnterAuthCodeTrying DomainTransferInEnterAuthCode = "trying" Link to this property const DomainTransferInEnterAuthCodeRejected DomainTransferInEnterAuthCode = "rejected" Link to this property
Link to this property
UnlockDomain DomainTransferInUnlockDomainOptional Status of the domain-unlock step at the foreign registrar. One of the following: const DomainTransferInUnlockDomainNeeded DomainTransferInUnlockDomain = "needed" Link to this property const DomainTransferInUnlockDomainOk DomainTransferInUnlockDomain = "ok" Link to this property const DomainTransferInUnlockDomainPending DomainTransferInUnlockDomain = "pending" Link to this property const DomainTransferInUnlockDomainTrying DomainTransferInUnlockDomain = "trying" Link to this property const DomainTransferInUnlockDomainUnknown DomainTransferInUnlockDomain = "unknown" Link to this property
Link to this property
Link to this property UpdatedAt TimeOptional 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 Go HTTPTypeScriptPythonGoTerraform ``` package main import ( "context" "fmt" "github.com/cloudflare/cloudflare-go" "github.com/cloudflare/cloudflare-go/option" "github.com/cloudflare/cloudflare-go/registrar" ) func main() { client := cloudflare.NewClient( option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"), ) page, err := client.Registrar.Domains.List(context.TODO(), registrar.DomainListParams{ AccountID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"), }) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", page) } ``` 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 } } ```