Create and track domain registration orders in batches.
List your orders
Returns a paginated list of all domain registration orders you've created.
query Parameters
limitoffsetstatusList your orders › Responses
List of orders
successCreate domain registration orders
Register up to 50 domains in a single batch. Returns a batchId for tracking the entire batch's progress.
Each item in the items array has its own domain, provider, term, and nameservers — so a single batch can mix multiple registrars and TLDs.
Pricing: prices are looked up automatically from the registrar catalogue based on provider + TLD + term. You cannot override prices via the API — this prevents clients from spoofing low prices. If a price isn't available for a TLD on the chosen provider, the request fails with 400.
Domains are processed in parallel. Order processing is split into two stages:
- Registration — submitting each order to the registrar (fast, usually 1–2 seconds per order).
- Configuration — applying the requested nameservers (slower for Dynadot/Spaceship because the domain must be fully provisioned on the registrar side before NS can be set, with retries).
Poll /orders/batch/{batchId} to track both stages independently, or subscribe to the orders.registered webhook to react as soon as stage 1 finishes and orders.completed for the fully-done signal.
Create domain registration orders › Request Body
clientIdYour client ID to associate the domains with
List of domains to register. Each item is independent — different providers/terms/nameservers in the same batch are OK.
Create domain registration orders › Responses
Orders created, registration started
successTrack batch progress
Poll this endpoint to track the progress of a batch of orders. Order processing is split into two stages: registration (submitting the order to the registrar) and configuration (applying the requested nameservers). The response breaks progress down by both stages so you can surface "registered" and "fully done" separately in your UI.
registered— how many orders have cleared the registration stage (statusesREGISTERED,SETTING_NS, orCOMPLETED).configuring— how many are currently in NS setup (SETTING_NS).completed— how many are fully finished (COMPLETED).failed— how many ended inFAILED(at either stage).pending— remaining orders still inPENDINGorREGISTERING.stages.registration.done— true once every order has either finished registration or failed.stages.configuration.done/ top-leveldone— true once the whole batch is terminal.
path Parameters
batchIdTrack batch progress › Responses
Batch status
success