Batch names
The keyed name resource for up to 100 names in one call.
One entry per name, in the request's order: the keyed GET /names/{name} resource, { name, tracked: false } for a name the catalog never stored, or { name, error: "validation_failed" } for an entry that is not a name. No live read. Billed one request per name sent, refused entries included.
plan_required.Keep a key on a server: a page a visitor loads shows it to everyone.
Connect on RapidAPIAlso inDomain Availability API
Request
fieldsstringOptionalQueryComma-separated top-level keys to keep; an unknown key answers 400 unsupported_field.
namesstring[]RequiredBody1 to 100 names.
curl -X POST "https://api.unique.domains/v1/names/batch" \
-H "Authorization: Bearer YOUR_MEMBER_KEY" \
-H "Content-Type: application/json" \
-d '{
"names": [
"get.plumbing",
"zorbly.ai",
"[email protected]"
]
}'const response = await fetch("https://api.unique.domains/v1/names/batch", {
method: "POST",
headers: {
"Authorization": "Bearer YOUR_MEMBER_KEY",
"Content-Type": "application/json",
},
body: JSON.stringify({
"names": [
"get.plumbing",
"zorbly.ai",
"[email protected]"
]
}),
});
const data = await response.json();
console.log(data);import requests
response = requests.post(
"https://api.unique.domains/v1/names/batch",
headers={
"Authorization": "Bearer YOUR_MEMBER_KEY",
"Content-Type": "application/json",
},
json={
"names": [
"get.plumbing",
"zorbly.ai",
"[email protected]"
]
},
)
print(response.json())req, err := http.NewRequest("POST", "https://api.unique.domains/v1/names/batch", strings.NewReader(`{"names":["get.plumbing","zorbly.ai","[email protected]"]}`))
if err != nil {
panic(err)
}
req.Header.Set("Authorization", "Bearer YOUR_MEMBER_KEY")
req.Header.Set("Content-Type", "application/json")
res, err := http.DefaultClient.Do(req)$ch = curl_init();
curl_setopt_array($ch, [
CURLOPT_URL => "https://api.unique.domains/v1/names/batch",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
"names" => ["get.plumbing", "zorbly.ai", "[email protected]"],
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer YOUR_MEMBER_KEY",
"Content-Type: application/json",
],
]);
$response = curl_exec($ch);uri = URI("https://api.unique.domains/v1/names/batch")
request = Net::HTTP::Post.new(uri)
request["Authorization"] = "Bearer YOUR_MEMBER_KEY"
request["Content-Type"] = "application/json"
request.body = JSON.dump({
"names": [
"get.plumbing",
"zorbly.ai",
"[email protected]"
]
})
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }Response
idstring | nulldom_<uuid>; null when tracked is false.
namestringendingstringtrackedbooleanThe catalog stores the name.
statusstringWhere the name stands for a buyer. A list row's stored status reads here as: resell is for_sale (at_auction at a drop-catch venue), premium is free_premium.
lifecyclestring | nulldropobjectownableNowbooleanpriceobjectregistryobjectparkingstring | nullThe parking or sale venue id.
lengthinteger | nullformatstring | nullshapestring | nullwordobject | nullratingobjectverdictobject | nullKeyed.
valueobject | nullKeyed.
compsobjectErrors
{
"data": [
{
"id": "dom_4efccac7-d9df-4c96-a076-3e0cc64220ec",
"name": "get.plumbing",
"ending": "plumbing",
"tracked": true,
"status": "for_sale",
"lifecycle": "active",
"drop": {
"kind": "none"
},
"ownableNow": false,
"price": {
"kind": "aftermarket",
"firstYear": null,
"registrar": null,
"renewal": null,
"transfer": null,
"isPromo": null,
"renewalTrap": false,
"regularPrice": null
},
"registry": {
"createdAt": "2020-06-03T08:30:53.000Z",
"updatedAt": "2026-08-12T04:41:40.000Z",
"expiresAt": "2027-06-03T08:30:53.000Z",
"registryUpdatedAt": "2026-10-22T13:39:28.000Z",
"registrar": {
"name": "GoDaddy.com, LLC",
"ianaId": 146,
"url": null
}
},
"parking": "afternic",
"length": 3,
"format": null,
"shape": "single",
"word": {
"id": "wrd_23922",
"word": "get",
"slug": "get"
},
"rating": {
"band": "prime"
},
"comps": {
"tier": "same_word",
"count": 10,
"medianUsd": 2677,
"endingsSoldOn": 0
},
"verdict": {
"rating": "good",
"confidence": "medium"
},
"value": {
"value": 4200,
"upsidePercent": null,
"liquidity": "medium"
}
},
{
"name": "zorbly.ai",
"tracked": false
},
{
"name": "[email protected]",
"error": "validation_failed"
}
],
"meta": {
"asOf": "2026-11-05T08:00:00Z",
"cursor": null,
"limit": null
},
"links": {
"self": "https://api.unique.domains/v1/names/batch",
"next": null,
"register": null,
"product": null,
"dataset": null
}
}