ResellerHQ
Log inTry the sandbox free
GuidesAPI reference
AccountBranded nameservers

Get your branded nameserver set

GET
/v1/account/branded-nameservers

Your one branded nameserver set (#344), or null if you have none yet.

Authorization

apiKey
headerAuthorizationBearer <token>

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

Response Body

Success

application/json
  1. response

Success

set*|null
curl -X GET "https://example.com/v1/account/branded-nameservers"
{  "set": {    "id": "bns_01K6XJ4Q8ZT3M9R5V2B7WDHNCA",    "carrierDomainId": "dom_01K6XJ4Q8ZT3M9R5V2B7WDHNCA",    "carrierDomain": "acme-hosting.com",    "names": [      "ns1.acme-hosting.com",      "ns2.acme-hosting.com"    ],    "status": "pending",    "checks": [      {        "name": "ns1.acme-hosting.com",        "status": "pending",        "lastCheckedAt": null,        "failure": null      }    ],    "usedByCount": 0,    "createdAt": "2026-10-07T11:04:31.000Z",    "updatedAt": "2026-10-07T11:04:31.000Z"  }}

Check a hostname now POST

Runs the CNAME check immediately, the same one the worker runs in the background, and reaches it even if repeated failure has parked it.

Create your branded nameserver set POST

2 to 4 hostnames under a domain you hold with us, each given a host record and checked at once, so a correctly-pointed set comes back already ready rather than making you poll. Refused while you already have a set: remove it first.