FreeDomain Check API

Get name

GET/names/{name}No key

The stored answer for one domain name: status, drop day, price today, registry facts, word facts and similar sales.

Read from the stored lookup rows, never live (POST /names/{name}/check is the live path). Free carries the website lookup's public contract: the rating as a band, no value, no checked time. Keyed adds the regular price behind a promotion, the exact rating, the verdict and the value facts. A name the catalog never stored answers 200 with tracked: false and empty facts, never 404.

AccessNo key. Limited per address; a key adds the paid fields.

BillingOne call.

FormatsJSON

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.

curl -X GET "https://api.unique.domains/v1/names/get.plumbing"

const response = await fetch("https://api.unique.domains/v1/names/get.plumbing", {
    method: "GET",
});

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

import requests

response = requests.get(
    "https://api.unique.domains/v1/names/get.plumbing",
)

print(response.json())

req, err := http.NewRequest("GET", "https://api.unique.domains/v1/names/get.plumbing", nil)
if err != nil {
    panic(err)
}

res, err := http.DefaultClient.Do(req)

$ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL => "https://api.unique.domains/v1/names/get.plumbing",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($ch);

uri = URI("https://api.unique.domains/v1/names/get.plumbing")
request = Net::HTTP::Get.new(uri)

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

Errors

validation_failed400

A value is not valid

rate_limited429

Too many requests

internal500

Unexpected error

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
    },
    "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
    }
  },
  "meta": {
    "asOf": null,
    "cursor": null,
    "limit": null
  },
  "links": {
    "self": "https://api.unique.domains/v1/names/get.plumbing",
    "next": null,
    "register": null,
    "product": null,
    "dataset": null
  }
}

Get name

Request

Response

Errors

Related endpoints