Get a domain's registration
Returns the registration or transfer state of an apex domain by id or hostname, or an unregistered record when Spacefast holds no registration for it. Pass teamId to restrict live registrations and retained failed purchases to that team. Pass includeCheckout=true to recover an existing open Stripe payment in purchase.checkout when authorized to purchase the domain. A payment-link lookup failure sets purchase.checkoutUnavailable without hiding registration status. This read never opens another checkout. After payment a purchase moves pending_payment → pending_registration → active; a failed one carries failureReason and its refund in purchase, and stays readable after the failed purchase releases its domain.
Request
- Base URL: https://api.spacefast.com
- URL: https://api.spacefast.com/v1/domains/{domainId}/registration
- Auth: one of:
- HTTP bearer
- OAuth 2 (authorization code, authorization URL https://api.spacefast.com/v1/auth/oauth2/authorize, token URL https://api.spacefast.com/v1/auth/oauth2/token; client credentials, token URL https://api.spacefast.com/v1/auth/oauth2/token, scopes: domains:read)
Path parameters
Query parameters
Return only this team's registration, including retained failed purchases. Use this when a hostname may have purchase history in more than one team.
Request an existing payment link when authorized to purchase this domain. Omit for registration status without a payment-provider lookup.
Response
Response for status 200
Changes
No recorded changes to this operation across all 1 revision of this API.