FreeDomain Check API

Get name auction

GET/names/{name}/auctionNo key

The open auction of one name, if any: venue, deadline, bid and the first-year cost.

data is null without an open listing. The venue is named by id and label; the first-year cost only when the venue's rule is verified; bidsJumped when the bid count rose in the last 24 hours.

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

Connect on RapidAPIAlso inDomain Auctions 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/auction"

Response

venuestring
venueLabelstring
endsAtstring
bidnumber | null
bidCountinteger | null
currencystring
firstYearnumber | null
bidsJumpedboolean

Errors

validation_failed400

A value is not valid

rate_limited429

Too many requests

internal500

Unexpected error

200 · application/jsonExample
{
  "data": {
    "venue": "dynadot",
    "venueLabel": "Dynadot",
    "endsAt": "2026-11-06T18:00:00.000Z",
    "bid": 145,
    "bidCount": 9,
    "currency": "USD",
    "firstYear": 157.99,
    "bidsJumped": true
  },
  "meta": {
    "asOf": null,
    "cursor": null,
    "limit": null
  },
  "links": {
    "self": "https://api.unique.domains/v1/names/get.plumbing/auction",
    "next": null,
    "register": null,
    "product": null,
    "dataset": null
  }
}

API status

Ask AI about Unique Domains