API reference

Every route of the ResellerHQ REST API, with its parameters, responses and errors.

The API is REST over HTTPS. Requests and responses are JSON, and every route is described by an OpenAPI 3.1 document that these pages are generated from.

Base URL

https://resellerhq.com/api/v1

Making a request

Send your API key as a bearer token. A rhq_test_ key reaches the sandbox and a rhq_live_ key the live side; nothing else in the request changes.

curl https://resellerhq.com/api/v1/account \
  -H "Authorization: Bearer $RHQ_API_KEY"

Each page has a Try in Playground button that sends the request from your browser. Use a sandbox key there.

Conventions


Money	Integers in minor units. `1200` is $12.00. Your wallet and the wholesale it pays are in US cents; a customer price, sale or invoice is in the minor units of its own `currency`. See Currency.
Ids	Strings with a prefix that says what they are: `num_`, `ord_`, `dom_`, `lic_`, `cus_`.
Times	ISO 8601 timestamps in UTC, such as `2026-10-07T11:04:31.000Z`.
Lists	Take `limit` and `cursor`, and return `data` and `nextCursor`. See pagination.
Retries	Routes that spend money take an `Idempotency-Key` header. See Idempotency.
Errors	Always `{ error, message, requestId }`. Branch on `error`. See Errors.
Rate limit	300 requests a minute per key.