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
namestringRequiredPathA 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.
fieldsstringOptionalQueryComma-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"
const response = await fetch("https://api.unique.domains/v1/names/get.plumbing/auction", {
method: "GET",
});
const data = await response.json();
console.log(data);import requests
response = requests.get(
"https://api.unique.domains/v1/names/get.plumbing/auction",
)
print(response.json())req, err := http.NewRequest("GET", "https://api.unique.domains/v1/names/get.plumbing/auction", 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/auction",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($ch);uri = URI("https://api.unique.domains/v1/names/get.plumbing/auction")
request = Net::HTTP::Get.new(uri)
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }Response
venuestringvenueLabelstringendsAtstringbidnumber | nullbidCountinteger | nullcurrencystringfirstYearnumber | nullbidsJumpedbooleanErrors
{
"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
}
}