Skip to main content
POST
Register domain

Authorizations

Authorization
string
header
required

API key authentication via Bearer token

Headers

idempotency-key
string
required

Key that makes this request safe to retry. Reuse the same value when retrying a request that may already have succeeded — the original response is replayed with an Idempotency-Replay: true header. Use a new value for a new operation.

Required string length: 1 - 255
Example:

"9f8c2b1a-4d3e-4a6b-8c1d-2e3f4a5b6c7d"

Body

application/json
domain
string
required
Required string length: 1 - 253
Pattern: ^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?(\.[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?)*$
maxAmountCents
integer
required
contact
object
required
periodYears
integer
default:1

Initial registration period in years (1-10). Some domain endings constrain the initial term (.ai registers for a minimum of 2 years, .co for at most 5); an out-of-range period fails with REGISTRATION_PERIOD_UNSUPPORTED before anything is charged.

Required range: 1 <= x <= 10
autoRenew
boolean
default:true

Response

Register domain

data
object
required
meta
object
Last modified on October 6, 2026