Create Order

Create a domain order without immediate payment.

This endpoint validates domain availability, retrieves pricing from the registrar provider, and creates a pending order. The organization can then submit a manual payment and allocate it to the order.

Returns order details including price, order_id, and payment instructions.

POST /api/v1/registrar/order

Create Order

cURL

curl --request POST \
  --url https://api.dotlet.net/api/v1/registrar/order \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "domain": "<string>",
  "contact": {
    "first_name": "<string>",
    "last_name": "<string>",
    "email": "[e-mail]",
    "phone": "<string>",
    "address1": "<string>",
    "city": "<string>",
    "state": "<string>",
    "postal_code": "<string>",
    "country": "<string>",
    "organization": "<string>",
    "address2": "<string>"
  },
  "years": 1,
  "payment_method": "card",
  "nameservers": [
    "<string>"
  ],
  "privacy": true,
  "auto_renew": true,
  "registrar": "namecheap",
  "setup_dns": false,
  "dns_provider": "cloudflare"
}
'

201

{
  "order_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "domain_name": "<string>",
  "years": 123,
  "price": "<string>",
  "currency": "<string>",
  "checkout_url": "<string>",
  "banking_details": {
    "bank_name": "<string>",
    "account_name": "<string>",
    "account_number": "<string>",
    "routing_number": "<string>"
  }
}

Authorizations

APIKeyHeaderHTTPBearer

X-API-Key · string · header · required

Body

application/json

Request to create a domain order (without immediate payment)

domain · string · required

Required string length: 1 - 255

contact · RegistrantContactSchema · object · required

Contact information for domain registration

Show child attributes

years · integer · default: 1

Required range: 1 <= x <= 10

payment_method · enum<string> · default: card

Payment method: 'wire' or 'card'

Available options: wire, card

nameservers · string[] | null

privacy · boolean · default: true

auto_renew · boolean · default: true

registrar · string · default: namecheap

Registrar to use (currently only namecheap is supported)

setup_dns · boolean · default: false

Automatically setup DNS after purchase

dns_provider · string · default: cloudflare

DNS provider to use for setup

Response

201

application/json

Successful Response

Response for domain order with payment status

order_id · string<uuid> · required

domain_name · string · required

years · integer · required

price · string · required

Pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$

currency · string · required

status · enum<string> · required

Available options: pending, ready_to_process, price_changed, processing, completed, failed, cancelled, refunded

checkout_url · string | null

banking_details · BankDetails · object | null

Show child attributes