Check Domain Availability
http
POST /domains/check
Parameters
| Field | Type | Required | Description |
|---|---|---|---|
| domains | array | Yes | Array of domain names to check (max 50) |
| accurate | boolean | No | true asks each registry live (definitive, a few seconds slower). Default false checks zone data refreshed daily, falling back to the registry for names it can’t answer. |
A name without an extension is checked as .com. Names we can’t check or price (an extension we don’t offer, a lookup that failed) are left out, so the list can be shorter than the one sent. price is the 1-year register price, with any sale running now (a premium name’s own price); renewal_price is the regular renewal price.
Response
json
[
{
"domain": "example.com",
"available": true,
"premium": false,
"price": 12.95,
"renewal_price": 14.95,
"min_years": 1,
"max_years": 10
}
]
Example
bash
curl -X POST -H "Authorization: Bearer crane_..." \
-H "Content-Type: application/json" \
-d '{"domains": ["example.com", "example.net"]}' \
https://namecrane.org/api/v1/domains/check