Skip to content

Check availability

Is this domain available, and what would it cost? Costs 1 quota point, and the answer is cached for 10 seconds per account. Together with bulk-search it is limited to 2 calls per second — see Rate limits.

Request

{
"domainName": "apiname.com"
}

Response — 200, available domain

{
"success": true,
"code": "1000",
"reason": null,
"operationMessage": null,
"info": {
"domainName": "apiname.com",
"tld": "com",
"status": "AVAILABLE",
"reason": null,
"isPremium": false,
"isDocumentRequired": false,
"price": 11.40,
"currency": "USD",
"period": 1
}
}

Response — 200, taken domain

{
"success": true,
"code": "2302",
"reason": "Domain exists",
"info": {
"domainName": "apiname.com",
"tld": "com",
"status": "NOTAVAILABLE",
"reason": "Domain exists",
"isPremium": false,
"isDocumentRequired": false,
"price": 11.40,
"currency": "USD",
"period": 1
}
}

info.status values

Value Meaning and what to do
AVAILABLE Registrable now. Proceed to register.
NOTAVAILABLE Taken. It may still be transferable — check with /transfers/check.
UNSUPPORTEDTLD We do not sell this extension. Do not retry.
INVALIDDOMAINNAME The name is syntactically invalid.
ERROR The registry lookup failed. Retry after a short pause.
NONE No result returned.

Fields that change your flow

Field What it means for you
price Your selling price for the shortest registration term this TLD offers — not necessarily one year. Check period.
isPremium The registry prices this name in a fee class other than standard: a premium tier, or a tier name of the registry’s own. price is that registry quote with your margin applied, and you can only register, renew or transfer it for one year.
isDocumentRequired The registry asks for supporting documents for this particular name. Registration will not complete until you upload documents and the registry approves them. false means the registry asked for none when you searched; we never ask for documents on our own. The registry gives its final answer when you register, so still read status in the registration response.

Errors

Code Meaning and fix
DnaValidationError domainName empty.
Dna.DomainService:Domain:10005 Invalid domain name.
Dna.DomainService:Domain:10004 We do not sell this extension.
Dna.DomainService:Domain:10017 Registry search temporarily unavailable. Retry.
Dna.DomainService:Price:10001 No price configured for this extension. Open a ticket.

Up to 30 domains in one call. Use this for search-result pages and extension suggestions.

Request — a JSON array, not an object

[
{ "domainName": "apiname.com" },
{ "domainName": "apiname.net" },
{ "domainName": "apiname.org" },
{ "domainName": "apiname.com.tr" }
]

Response — 200

{
"success": true,
"code": "1000",
"reason": null,
"operationMessage": null,
"infos": [
{ "domainName": "apiname.com", "tld": "com", "status": "NOTAVAILABLE",
"isPremium": false, "isDocumentRequired": false,
"price": 11.40, "currency": "USD", "period": 1 },
{ "domainName": "apiname.net", "tld": "net", "status": "AVAILABLE",
"isPremium": false, "isDocumentRequired": false,
"price": 13.20, "currency": "USD", "period": 1 },
{ "domainName": "apiname.org", "tld": "org", "status": "AVAILABLE",
"isPremium": false, "isDocumentRequired": false,
"price": 12.80, "currency": "USD", "period": 1 }
]
}

Errors

Code Meaning and fix
Dna.Domainservice:Domain:10036 More than 30 domains. Split into batches of 30.