Domains

Search for a domain

GET
/v1/domains/search

Checks one name across every ending on offer, with your price for each. With customerId, each also says what that customer pays, promotions counted. A premium name is left out until it can be priced properly, and one the registrar could not check comes back unknown.

Authorization

apiKey
headerAuthorizationBearer <token>

An API key from the Developers page. rhq_test_ keys reach the sandbox, rhq_live_ keys the live side.

Query Parameters

query*string

A bare name, or a full domain to check that one ending first

Length1 <= length <= 253
customerId?string

Also return what this customer pays for a first purchase

coupon?string

Also count the promotion this coupon unlocks, as an order sending it would

Length1 <= length <= 40

Response Body

Success

application/json
  1. response

Success

data*array<>
curl -X GET "https://example.com/v1/domains/search?query=northwind-telecom&customerId=cus_01K6XJ4Q8ZT3M9R5V2B7WDHNCA&coupon=LAUNCH25"
{  "data": [    {      "domain": "northwind-telecom.com",      "available": true,      "price": 1440,      "unknown": true,      "customerPrice": 1799,      "customerCurrency": "USD",      "customerNormalPrice": 1999,      "customerPromotionEndsAt": "2026-12-01T00:00:00.000Z",      "privacyPrice": 499,      "customerPrivacyPrice": 599    }  ]}