CuriosDomain

Build on CuriosDomain.

Register, transfer, renew and manage domains from your own code with the REST API, or let Claude do it for you through our MCP connector. Both use the same account, balance and API keys.

Quick start

Every request goes to https://api.curiosdomain.com. Search and pricing need no key:

curl "https://api.curiosdomain.com/v1/domains/check?name=fernhollow&tlds=com,io"
// response
{ "currency": "USD",
  "results": [
    { "domain": "fernhollow.com", "available": true, "premium": false, "price": 13.99, "renewalPrice": 15.49 },
    { "domain": "fernhollow.io",  "available": true, "premium": false, "price": 44.99, "renewalPrice": 44.99 } ] }

Download the OpenAPI 3.1 spec to generate a client in any language.

Authentication

Create an account, then make a key under API & Claude in your dashboard. Send it as a bearer token. Keys start with cd_live_, or cd_test_ on the sandbox, where nothing is charged and no real domains are registered.

curl https://api.curiosdomain.com/v1/account \
  -H "Authorization: Bearer $CURIOSDOMAIN_KEY"

Create more keys with POST /v1/account/keys and revoke them with DELETE /v1/account/keys/{prefix}. A key is shown once, when it's created. Keep keys on your server and never put them in browser code.

How buying works

Purchases take two calls, so your code always sees the exact price before money moves.

1. Add registrant details, once per account

curl -X PUT https://api.curiosdomain.com/v1/account/contact \
  -H "Authorization: Bearer $CURIOSDOMAIN_KEY" -H "Content-Type: application/json" \
  -d '{"firstName":"Ada","lastName":"Lovelace","email":"ada@example.com","phone":"+1 415 555 0123",
       "address":"1 Market St","city":"San Francisco","state":"CA","postcode":"94105","country":"US"}'

2. Get a quote

curl -X POST https://api.curiosdomain.com/v1/quotes \
  -H "Authorization: Bearer $CURIOSDOMAIN_KEY" -H "Content-Type: application/json" \
  -d '{"action":"register","domain":"fernhollow.com","years":2}'
{ "confirmationToken": "q_8c1f…", "total": { "amount": 29.48, "currency": "USD" },
  "renewalPricePerYear": { "amount": 15.49, "currency": "USD" },
  "description": "Register fernhollow.com for 2 years: $29.48, then $15.49/year.",
  "expiresAt": "2026-11-21T14:50:14Z" }

action can be register, transfer (include authcode) or renew. A quote is valid for 15 minutes and can be used once.

3. Confirm the order

curl -X POST https://api.curiosdomain.com/v1/orders \
  -H "Authorization: Bearer $CURIOSDOMAIN_KEY" -H "Content-Type: application/json" \
  -H "Idempotency-Key: 5f2b7d0e-order-42" \
  -d '{"confirmationToken":"q_8c1f…"}'
{ "reference": "CD-6CB0F127", "domain": "fernhollow.com", "status": "registered",
  "charged": { "amount": 29.48, "currency": "USD" }, "expiresAt": "2028-11-21T00:00:00Z" }
Orders are paid from your prepaid account balance. If the balance is too low you get 402 insufficient_balance and nothing is charged. If the registry rejects an order, the charge is refunded automatically. Send an Idempotency-Key so a retried request never buys twice.

Endpoints

EndpointWhat it does
GET/v1/domains/checkAvailability and prices. name, optional tlds. No key needed.
GET/v1/pricingRegister, renew and transfer prices per extension. No key needed.
GET/v1/accountEmail, balance, contact on file, domain count.
PUT/v1/account/contactSet the registrant used for new domains.
GET POST/v1/account/keysList or create API keys.
DELETE/v1/account/keys/{prefix}Revoke a key.
POST/v1/quotesPrice a register, transfer or renew. Returns a confirmation token.
POST/v1/ordersConfirm a quote. Charges your balance.
GET/v1/domainsEvery domain in your account.
GET/v1/domains/{domain}Status, expiry, auto-renew, privacy, transfer lock, nameservers.
PATCH/v1/domains/{domain}Change nameservers, autoRenew, privacyProtect or transferLock.
GET/v1/domains/{domain}/authcodeAuthorisation code for moving the domain elsewhere.

DNS records

Domains registered here have DNS hosted here unless you change the nameservers. Record names can be @ for the root, a label such as www, or a fully qualified name.

GET/v1/domains/{domain}/dnsList records.
POST/v1/domains/{domain}/dns/recordsAdd one record.
DELETE/v1/domains/{domain}/dns/recordsDelete by name and type, plus content when several match.
PUT/v1/domains/{domain}/dnsReplace every record in one call.
curl -X POST https://api.curiosdomain.com/v1/domains/fernhollow.com/dns/records \
  -H "Authorization: Bearer $CURIOSDOMAIN_KEY" -H "Content-Type: application/json" \
  -d '{"name":"@","type":"MX","content":"mx1.mailhost.example","priority":10}'

SSL, SiteLock and Premium DNS

Add-ons use the same quote → order flow as domains. List what's available, with prices, from GET /v1/products (no key needed).

Quote actionFields
sslproduct, domain (use *.example.com for wildcards), years, csr, optional san, validationMethod (DNS, EMAIL or FILE) and validationEmail. For domains whose DNS is hosted here, DNS validation records are added automatically.
ssl_renewid, years, csr
acmeproduct, domainNames, years. The order response returns the ACME directory URL and EAB credentials once.
acme_renewid, years
sitelockplan, domain
premium_dnsdomain (one of yours, with DNS hosted here)
curl -X POST https://api.curiosdomain.com/v1/quotes \
  -H "Authorization: Bearer $CURIOSDOMAIN_KEY" -H "Content-Type: application/json" \
  -d '{"action":"acme","product":"sectigo_acme_dv","domainNames":["example.com","www.example.com"],"years":1}'
GET/v1/sslYour certificates.
GET/v1/ssl/{id}Status, plus the validation steps still needed (DNS record, file or email).
GET/v1/ssl/{id}/downloadformat = crt, ca_bundle, ca, pkcs7 or zip.
POST/v1/ssl/{id}/reissueReissue with a new csr. Free.
DELETE/v1/ssl/{id}Revoke. Optional reason.
GET/v1/acme, /v1/acme/{id}Your ACME subscriptions.
POST/v1/acme/{id}/credentialsNew EAB credentials (the old ones stop working).
DELETE/v1/acme/{id}Cancel a subscription.
GET/v1/sitelockYour protected sites.
POST/v1/sitelock/{domain}/loginSingle-use sign-in link to the SiteLock dashboard.
DELETE/v1/sitelock/{domain}Remove SiteLock from a site.
PATCH/v1/domains/{domain}{"dnssec": true} turns on DNSSEC (free). {"premiumDns": false} switches back to free DNS.

Errors and limits

Errors use standard HTTP status codes and a consistent body:

{ "error": { "code": "insufficient_balance", "message": "This costs $13.99 but your balance is $0.00. Top up your balance and try again." } }
StatusCommon codes
400invalid_domain invalid_record authcode_required invalid_contact
401unauthorized: missing or revoked key
402insufficient_balance
404domain_not_found (not in your account), quote_not_found
409not_available price_changed contact_required dns_not_hosted
410quote_expired
429rate_limited: 120 requests a minute per account, 30 without a key
502registry_unavailable: safe to retry with the same Idempotency-Key

Connect Claude

The CuriosDomain connector lets Claude search for names, show you quotes, and buy or change domains for you. Claude always shows the price and asks before buying; an order can't go through without the token from a quote you approved.

In Claude, open Settings → Connectors → Add custom connector, name it CuriosDomain, and paste:

https://api.curiosdomain.com/mcp

Claude opens CuriosDomain so you can sign in (or create an account) and approve access. You can disconnect Claude at any time from your dashboard.

What it looks like

Find me a .com for my pottery studio, something with "kiln".

kilnandclay.com is available for $13.99, then $15.49/year. Want me to register it for a year?

Yes, and point it at my Squarespace site.

Registered kilnandclay.com (reference CD-84716D05). I've added the A and CNAME records Squarespace needs. They usually take effect within an hour.

Add malware scanning too.

SiteLock Basic for kilnandclay.com is $19.99 a year. Shall I add it?

Tools

ToolWhat Claude can do
search_domainsCheck availability and prices
get_pricingRead the price list
get_accountSee your balance and whether contact details are on file
set_registrant_contactSave owner details you give it
get_quotePrice a registration, transfer or renewal. Buys nothing.
confirm_orderComplete a quote you've approved and charge your balance
list_my_domains, get_domainSee your domains and their settings
update_domain_settingsChange nameservers, auto-renew, privacy or the transfer lock
get_auth_codeGet the code to move a domain to another registrar
get_dns_records, add_dns_record, delete_dns_recordManage DNS
list_productsSee SSL certificates, ACME subscriptions, SiteLock plans and Premium DNS, with prices
list_ssl_certificates, get_ssl_certificate, download_ssl_certificateTrack validation and get the certificate files
reissue_ssl_certificate, revoke_ssl_certificateReplace or revoke a certificate
list_acme_subscriptions, get_acme_subscription, regenerate_acme_credentials, cancel_acme_subscriptionManage auto-renewing SSL
list_sitelock_sites, sitelock_login_link, cancel_sitelockManage SiteLock