Check availability + price

GET /v1/domain-purchases/check — is the hostname free, and what would it cost?

GET /v1/domain-purchases/check?hostname=acme.com

Quotes a hostname against the upstream registrar. No charge, no row written. Use this to show your end-user the price before they confirm.

Request

curl "https://api.domainee.dev/v1/domain-purchases/check?hostname=janesbakery.com" \
  -H "Authorization: Bearer $DOMAINEE_API_KEY"

Query parameters

Param	Required	Notes
`hostname`	✅	RFC 1123 hostname. Lowercased + trimmed automatically.

Response — `200 OK` (available)

{
  "hostname": "janesbakery.com",
  "available": true,
  "premium": false,
  "pricing": {
    "wholesaleCents": 1418,
    "feeCents": 100,
    "totalCents": 1518,
    "currency": "USD"
  }
}

Field	Notes
`available`	`true` if the hostname can be registered right now
`premium`	`true` if the registrar treats this as a premium-tier name (different pricing rules, see below)
`pricing.wholesaleCents`	What the registrar charges us in cents
`pricing.feeCents`	Domainee's flat $1 operational fee (always 100 in v1)
`pricing.totalCents`	What we'll charge your workspace if you proceed
`pricing.currency`	Always `USD` for v1

Response — `200 OK` (unavailable)

{
  "hostname": "google.com",
  "available": false,
  "premium": false,
  "pricing": null
}

pricing is null when the hostname can't be registered (already taken, banned TLD, etc.).

Premium domains

Some TLDs and short names carry a registry-set premium price (think one.com, two-letter .io names, etc.). When the registrar flags a name as premium, pricing.wholesaleCents reflects the real premium price — not the regular .com/.io tier — and the premium flag is true. Always re-check the price right before a purchase; premium pricing can change between the quote and the buy.

Notes

This endpoint is cheap and idempotent. Call it as often as you like from your domain-search UI.
Pricing is live from the registrar, so currency conversions, sales, and premium-name pricing all flow through here.
For comparing many hostnames in one shot, just call this in parallel. We'll add a batch variant if usage warrants it.