## Get Registration `client.Registrar.Registrations.Get(ctx, domainName, query) (*Registration, error)` **get** `/accounts/{account_id}/registrar/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. ### Parameters - `domainName string` Fully qualified domain name (FQDN) including the extension (e.g., `example.com`, `mybrand.app`). The domain name uniquely identifies a registration — the same domain cannot be registered twice, making it a natural idempotency key for registration requests. - `query RegistrationGetParams` - `AccountID param.Field[string]` Identifier ### Returns - `type Registration struct{…}` A domain registration resource representing the current state of a registered domain. - `AutoRenew bool` Whether the domain will be automatically renewed before expiration. - `CreatedAt Time` When the domain was registered. Present when the registration resource exists. - `DomainName string` Fully qualified domain name (FQDN) including the extension (e.g., `example.com`, `mybrand.app`). The domain name uniquely identifies a registration — the same domain cannot be registered twice, making it a natural idempotency key for registration requests. - `ExpiresAt Time` When the domain registration expires. Present when the registration is ready; may be null only while `status` is `registration_pending`. - `Locked bool` Whether the domain is locked for transfer. - `PrivacyMode RegistrationPrivacyMode` Current WHOIS privacy mode for the registration. - `const RegistrationPrivacyModeRedaction RegistrationPrivacyMode = "redaction"` - `Status RegistrationStatus` Current registration status. - `active`: Domain is registered and operational - `registration_pending`: Registration is in progress - `expired`: Domain has expired - `suspended`: Domain is suspended by the registry - `redemption_period`: Domain is in the redemption grace period - `pending_delete`: Domain is pending deletion by the registry - `const RegistrationStatusActive RegistrationStatus = "active"` - `const RegistrationStatusRegistrationPending RegistrationStatus = "registration_pending"` - `const RegistrationStatusExpired RegistrationStatus = "expired"` - `const RegistrationStatusSuspended RegistrationStatus = "suspended"` - `const RegistrationStatusRedemptionPeriod RegistrationStatus = "redemption_period"` - `const RegistrationStatusPendingDelete RegistrationStatus = "pending_delete"` ### Example ```go 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"), ) registration, err := client.Registrar.Registrations.Get( context.TODO(), "example.com", registrar.RegistrationGetParams{ AccountID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"), }, ) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", registration.AutoRenew) } ``` #### Response ```json { "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 } ```