Skip to content
Start here

Registrar

RegistrarDomains

List domains
client.Registrar.Domains.List(ctx, query) (*SinglePage[Domain], error)
GET/accounts/{account_id}/registrar/domains
Get domain
client.Registrar.Domains.Get(ctx, domainName, query) (*DomainGetResponse, error)
GET/accounts/{account_id}/registrar/domains/{domain_name}
Update domain
client.Registrar.Domains.Update(ctx, domainName, params) (*DomainUpdateResponse, error)
PUT/accounts/{account_id}/registrar/domains/{domain_name}
ModelsExpand Collapse
type Domain struct{…}
ID stringoptional

Domain identifier.

maxLength32
Available booloptional

Shows if a domain is available for transferring into Cloudflare Registrar.

CanRegister booloptional

Indicates if the domain can be registered as a new domain.

CreatedAt Timeoptional

Shows time of creation.

formatdate-time
CurrentRegistrar stringoptional

Shows name of current registrar.

ExpiresAt Timeoptional

Shows when domain name registration expires.

formatdate-time
Locked booloptional

Shows whether a registrar lock is in place for a domain.

RegistrantContact DomainRegistrantContactoptional

Shows contact information for domain registrant.

Address string

Address.

City string

City.

Country string

The country in which the user lives.

maxLength30
FirstName string

User's first name

maxLength60
LastName string

User's last name

maxLength60
Organization string

Name of organization.

Phone string

User's telephone number

maxLength20
State string

State.

Zip string

The zipcode or postal code where the user lives.

maxLength20
ID stringoptional

Contact Identifier.

maxLength32
Address2 stringoptional

Optional address line for unit, floor, suite, etc.

Email stringoptional

The contact email address of the user.

maxLength90
Fax stringoptional

Contact fax number.

RegistryStatuses stringoptional

A comma-separated list of registry status codes. A full list of status codes can be found at EPP Status Codes.

SupportedTLD booloptional

Whether a particular TLD is currently supported by Cloudflare Registrar. Refer to TLD Policies for a list of supported TLDs.

TransferIn DomainTransferInoptional

Statuses for domain transfers into Cloudflare Registrar.

AcceptFoa DomainTransferInAcceptFoaoptional

Form of authorization has been accepted by the registrant.

One of the following:
const DomainTransferInAcceptFoaNeeded DomainTransferInAcceptFoa = "needed"
const DomainTransferInAcceptFoaOk DomainTransferInAcceptFoa = "ok"
ApproveTransfer DomainTransferInApproveTransferoptional

Shows transfer status with the registry.

One of the following:
const DomainTransferInApproveTransferNeeded DomainTransferInApproveTransfer = "needed"
const DomainTransferInApproveTransferOk DomainTransferInApproveTransfer = "ok"
const DomainTransferInApproveTransferPending DomainTransferInApproveTransfer = "pending"
const DomainTransferInApproveTransferTrying DomainTransferInApproveTransfer = "trying"
const DomainTransferInApproveTransferRejected DomainTransferInApproveTransfer = "rejected"
const DomainTransferInApproveTransferUnknown DomainTransferInApproveTransfer = "unknown"
CanCancelTransfer booloptional

Indicates if cancellation is still possible.

DisablePrivacy DomainTransferInDisablePrivacyoptional

Privacy guards are disabled at the foreign registrar.

One of the following:
const DomainTransferInDisablePrivacyNeeded DomainTransferInDisablePrivacy = "needed"
const DomainTransferInDisablePrivacyOk DomainTransferInDisablePrivacy = "ok"
const DomainTransferInDisablePrivacyUnknown DomainTransferInDisablePrivacy = "unknown"
EnterAuthCode DomainTransferInEnterAuthCodeoptional

Auth code has been entered and verified.

One of the following:
const DomainTransferInEnterAuthCodeNeeded DomainTransferInEnterAuthCode = "needed"
const DomainTransferInEnterAuthCodeOk DomainTransferInEnterAuthCode = "ok"
const DomainTransferInEnterAuthCodePending DomainTransferInEnterAuthCode = "pending"
const DomainTransferInEnterAuthCodeTrying DomainTransferInEnterAuthCode = "trying"
const DomainTransferInEnterAuthCodeRejected DomainTransferInEnterAuthCode = "rejected"
UnlockDomain DomainTransferInUnlockDomainoptional

Domain is unlocked at the foreign registrar.

One of the following:
const DomainTransferInUnlockDomainNeeded DomainTransferInUnlockDomain = "needed"
const DomainTransferInUnlockDomainOk DomainTransferInUnlockDomain = "ok"
const DomainTransferInUnlockDomainPending DomainTransferInUnlockDomain = "pending"
const DomainTransferInUnlockDomainTrying DomainTransferInUnlockDomain = "trying"
const DomainTransferInUnlockDomainUnknown DomainTransferInUnlockDomain = "unknown"
UpdatedAt Timeoptional

Last updated.

formatdate-time