POST /v1/domains/check

Check whether a domain is available to register through Warpweb, and what it costs.

Backed by Cloudflare Registrar. Pricing is passthrough plus a small markup; you see the final all-in number.

Cost: Free.

Request

curl -X POST https://api.warpweb.ai/v1/domains/check \
  -H "Authorization: Bearer wpwb_sk_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "brooksideplumbing.com"
  }'

Body

Field	Type	Required	Description
`domain`	string	yes	The domain to check, including TLD.

Response

When available:

{
  "domain": "brooksideplumbing.com",
  "available": true,
  "price_usd": 10.44,
  "renewal_price_usd": 10.44,
  "registration_period_years": 1,
  "tld_supported": true
}

When taken:

{
  "domain": "google.com",
  "available": false,
  "tld_supported": true
}

When the TLD isn’t supported by Warpweb’s registrar:

{
  "domain": "example.xyz",
  "available": null,
  "tld_supported": false,
  "message": "TLD .xyz is not currently supported. Attach an externally-registered domain via POST /v1/sites/:id/domains."
}

Fields

Field	Description
`available`	`true` if registerable through Warpweb, `false` if taken, `null` if the TLD is unsupported.
`price_usd`	All-in registration cost. What you pay; no surprise fees.
`renewal_price_usd`	What it’ll cost to renew. Almost always identical to `price_usd`.
`registration_period_years`	Minimum registration term. Most TLDs: 1 year.
`tld_supported`	Whether Warpweb can register this TLD. If `false`, register elsewhere and use `/v1/sites/:id/domains`.

Errors

Status	Error	Cause
400	`invalid_domain`	Domain string is malformed.

POST /v1/sites/:id/domains POST /v1/domains/register