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" }
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
| Endpoint | What it does |
|---|---|
GET/v1/domains/check | Availability and prices. name, optional tlds. No key needed. |
GET/v1/pricing | Register, renew and transfer prices per extension. No key needed. |
GET/v1/account | Email, balance, contact on file, domain count. |
PUT/v1/account/contact | Set the registrant used for new domains. |
GET POST/v1/account/keys | List or create API keys. |
DELETE/v1/account/keys/{prefix} | Revoke a key. |
POST/v1/quotes | Price a register, transfer or renew. Returns a confirmation token. |
POST/v1/orders | Confirm a quote. Charges your balance. |
GET/v1/domains | Every 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}/authcode | Authorisation 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}/dns | List records. |
POST/v1/domains/{domain}/dns/records | Add one record. |
DELETE/v1/domains/{domain}/dns/records | Delete by name and type, plus content when several match. |
PUT/v1/domains/{domain}/dns | Replace 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 action | Fields |
|---|---|
ssl | product, 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_renew | id, years, csr |
acme | product, domainNames, years. The order response returns the ACME directory URL and EAB credentials once. |
acme_renew | id, years |
sitelock | plan, domain |
premium_dns | domain (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/ssl | Your certificates. |
GET/v1/ssl/{id} | Status, plus the validation steps still needed (DNS record, file or email). |
GET/v1/ssl/{id}/download | format = crt, ca_bundle, ca, pkcs7 or zip. |
POST/v1/ssl/{id}/reissue | Reissue 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}/credentials | New EAB credentials (the old ones stop working). |
DELETE/v1/acme/{id} | Cancel a subscription. |
GET/v1/sitelock | Your protected sites. |
POST/v1/sitelock/{domain}/login | Single-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." } }
| Status | Common codes |
|---|---|
| 400 | invalid_domain invalid_record authcode_required invalid_contact |
| 401 | unauthorized: missing or revoked key |
| 402 | insufficient_balance |
| 404 | domain_not_found (not in your account), quote_not_found |
| 409 | not_available price_changed contact_required dns_not_hosted |
| 410 | quote_expired |
| 429 | rate_limited: 120 requests a minute per account, 30 without a key |
| 502 | registry_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.
claude mcp add --transport http curiosdomain https://api.curiosdomain.com/mcp
Then run /mcp in Claude Code and choose CuriosDomain to sign in. On a server with no browser, use an API key instead:
claude mcp add --transport http curiosdomain https://api.curiosdomain.com/mcp \ --header "Authorization: Bearer cd_live_YOUR_KEY"
Any client that supports Streamable HTTP. Clients that support MCP authorization can omit the header and sign in with OAuth; discovery starts at /.well-known/oauth-protected-resource.
{
"mcpServers": {
"curiosdomain": {
"type": "http",
"url": "https://api.curiosdomain.com/mcp",
"headers": { "Authorization": "Bearer cd_live_YOUR_KEY" }
}
}
}
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
| Tool | What Claude can do |
|---|---|
search_domains | Check availability and prices |
get_pricing | Read the price list |
get_account | See your balance and whether contact details are on file |
set_registrant_contact | Save owner details you give it |
get_quote | Price a registration, transfer or renewal. Buys nothing. |
confirm_order | Complete a quote you've approved and charge your balance |
list_my_domains, get_domain | See your domains and their settings |
update_domain_settings | Change nameservers, auto-renew, privacy or the transfer lock |
get_auth_code | Get the code to move a domain to another registrar |
get_dns_records, add_dns_record, delete_dns_record | Manage DNS |
list_products | See SSL certificates, ACME subscriptions, SiteLock plans and Premium DNS, with prices |
list_ssl_certificates, get_ssl_certificate, download_ssl_certificate | Track validation and get the certificate files |
reissue_ssl_certificate, revoke_ssl_certificate | Replace or revoke a certificate |
list_acme_subscriptions, get_acme_subscription, regenerate_acme_credentials, cancel_acme_subscription | Manage auto-renewing SSL |
list_sitelock_sites, sitelock_login_link, cancel_sitelock | Manage SiteLock |