Check availability
POST /api/v1/domains/search
Section titled “POST /api/v1/domains/search”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. |
POST /api/v1/domains/bulk-search
Section titled “POST /api/v1/domains/bulk-search”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. |