Skip to main content
POST
/
v1
/
domain-registrations
Register domain
curl --request POST \
  --url https://api.bizzyco.ai/v1/domain-registrations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'idempotency-key: <idempotency-key>' \
  --data '
{
  "domain": "<string>",
  "maxAmountCents": 123,
  "contact": {
    "firstName": "<string>",
    "lastName": "<string>",
    "address1": "<string>",
    "city": "<string>",
    "stateProvince": "<string>",
    "postalCode": "<string>",
    "country": "<string>",
    "email": "jsmith@example.com",
    "phone": "<string>",
    "label": "<string>",
    "organizationName": "<string>",
    "jobTitle": "<string>",
    "address2": "<string>"
  },
  "periodYears": 1,
  "autoRenew": true,
  "whoisPrivacy": true
}
'
{
  "data": {
    "operationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "domain": "<string>"
  },
  "meta": {
    "pagination": {
      "limit": 123,
      "offset": 123,
      "hasMore": true,
      "total": 123
    }
  }
}

Authorizations

Authorization
string
header
required

API key authentication via Bearer token

Headers

idempotency-key
string
required

Unique key that makes this request safe to retry. Reuse the same value when retrying a request that may already have succeeded; 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
maxAmountCents
integer
required
contact
object
required
periodYears
integer
default:1
Required range: 1 <= x <= 10
autoRenew
boolean
default:true
whoisPrivacy
boolean
default:true

Response

Register domain

data
object
required
meta
object
Last modified on June 15, 2026