PaidDomain Check API

Check name

POST/names/{name}/checkMember key

Reads one name live from its registry and a registrar, stores the answer and returns the keyed name resource.

Billed Live=1 when the live read answered (200, checked: true) or when the registry was asked and did not conclude (202); Live=0 when the answer came from storage (200, checked: false). Asking value or history answers 202 with the stored resource so far, Retry-After: 30 and Location; the check never runs the appraisal (POST /names/{name}/appraise does). 2,000 live checks a UTC day for the whole API, 200 per consumer.

AccessA member key (Founder or Investor) or a paid RapidAPI subscription to this API.

BillingOne call, plus one live check when the live read runs.

FormatsJSON

Keep a key on a server: a page a visitor loads shows it to everyone.

Connect on RapidAPIAlso inDomain Availability API

Request

namestringRequiredPath

A full domain name on an ending the catalog holds, lowercased, IDN as punycode. A bare word, a subdomain, an e-mail address or an unknown ending answers 400 validation_failed with reason and suggestion.

fieldsstringOptionalQuery

Comma-separated top-level keys to keep; an unknown key answers 400 unsupported_field.

blocksstring[]OptionalBody

Optional: the lanes to read. prices asks every registrar, registry forces the registry record. Default ["availability","registry","dns","prices"].

curl -X POST "https://api.unique.domains/v1/names/get.plumbing/check" \
  -H "Authorization: Bearer YOUR_MEMBER_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "blocks": [
      "availability",
      "registry"
    ]
  }'

const response = await fetch("https://api.unique.domains/v1/names/get.plumbing/check", {
    method: "POST",
    headers: {
        "Authorization": "Bearer YOUR_MEMBER_KEY",
        "Content-Type": "application/json",
    },
    body: JSON.stringify({
        "blocks": [
            "availability",
            "registry"
        ]
    }),
});

const data = await response.json();
console.log(data);

import requests

response = requests.post(
    "https://api.unique.domains/v1/names/get.plumbing/check",
    headers={
        "Authorization": "Bearer YOUR_MEMBER_KEY",
        "Content-Type": "application/json",
    },
    json={
        "blocks": [
            "availability",
            "registry"
        ]
    },
)

print(response.json())

req, err := http.NewRequest("POST", "https://api.unique.domains/v1/names/get.plumbing/check", strings.NewReader(`{"blocks":["availability","registry"]}`))
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/get.plumbing/check",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_POSTFIELDS => json_encode([
        "blocks" => ["availability", "registry"],
    ]),
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer YOUR_MEMBER_KEY",
        "Content-Type: application/json",
    ],
]);
$response = curl_exec($ch);

uri = URI("https://api.unique.domains/v1/names/get.plumbing/check")
request = Net::HTTP::Post.new(uri)
request["Authorization"] = "Bearer YOUR_MEMBER_KEY"
request["Content-Type"] = "application/json"
request.body = JSON.dump({
  "blocks": [
    "availability",
    "registry"
  ]
})

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }

Response

idstring | null

dom_<uuid>; null when tracked is false.

namestring

endingstring

trackedboolean

The catalog stores the name.

statusstring

Where 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 | null

dropobject

ownableNowboolean

priceobject

registryobject

parkingstring | null

The parking or sale venue id.

lengthinteger | null

formatstring | null

shapestring | null

wordobject | null

ratingobject

verdictobject | null

Keyed.

valueobject | null

Keyed.

compsobject

checkedboolean

The live read answered.

Errors

validation_failed400

A value is not valid

keyed_only403

A paid subscription is required

rate_limited429

Too many requests

budget_spent429

Today's budget is spent

internal500

Unexpected error

check_unavailable503

The live check is unavailable

200 · application/jsonExample

{
  "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"
    },
    "checked": true
  },
  "meta": {
    "asOf": "2026-11-05T08:00:00Z",
    "cursor": null,
    "limit": null
  },
  "links": {
    "self": "https://api.unique.domains/v1/names/get.plumbing/check",
    "next": null,
    "register": null,
    "product": null,
    "dataset": null
  }
}

Check name

Request

Response

Errors

Related endpoints