Registration
Registers a domain name under an existing customer account.
Before registering, always verify the domain is available using GET /api/v1/domains/availability. Attempting to register an unavailable domain will result in a failed order.
Customer requirement: The customer_id must correspond to an account previously created via POST /api/v1/customers/signup. The customer’s saved contact details are automatically used as the WHOIS registrant, admin, tech, and billing contacts for the domain.
Billing: A billing settlement is performed automatically before the registration is submitted to the registry. If the settlement fails, the registration will not proceed.
Duration: You may register for 1–10 years. Some TLDs enforce a minimum registration period — check TLD-specific requirements if registration fails for a short duration.
On success, the response includes an order_id which is required for subsequent operations such as renewal, DNS management, and privacy protection.
Authorizations
A personal access token. Obtain one from the dashboard under Settings > API Key. Include it in the Authorization header as Bearer <token>. Unauthenticated requests to protected routes return 401 Unauthorized.
Body
ID of the customer under whose account the domain will be registered.
85384231
Fully qualified domain name to register (e.g. example.com).
80"example.com"
Registration term in years (1–10).
1 <= x <= 101