CustomDomain™ docs
API referenceRegistrar

List the calling application's domain-purchase orders, newest first

GET
/sell/orders

Every order the application recorded (quoted, purchased, transferred, failed, or expired). A quote-only order that was never paid for is expired by the hourly reaper after 24 hours (status expired, with a purchase.confirmation.expired webhook), so "quoted" always means recent intent.

With a tenant API key it lists the orders of every application of the tenant, or of one with app_id (another tenant's id answers 404). A widget token minted with scope app, or a delegated agent token with domains:read, lists its own application's orders.

Authorization

AuthorizationBearer <token>

Short-lived widget JWT minted server-side via POST /v1/tokens. Scoped to one application (and optionally one domain).

In: header

Query Parameters

app_id?string

With a tenant API key, list the orders of this one application of the tenant.

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/sell/orders"
{  "orders": [    {      "orderId": "ord_1a2b3c",      "domain": "string",      "registrar": "string",      "status": "quoted",      "createdAt": "2019-08-24T14:15:22Z",      "regOrderId": "string",      "jobId": "string",      "link": "string",      "freeDomain": true    }  ],  "count": 0}
{  "code": "string",  "title": "string",  "details": "string"}
{  "code": "string",  "title": "string",  "details": "string"}
{  "code": "string",  "title": "string",  "details": "string"}