ResellerHQ
Log inTry the sandbox free
GuidesAPI reference
Sub-resellers

List a sub-reseller's number orders

GET
/v1/sub-resellers/{id}/orders

Orders with their numbers, newest first - the same shape your own GET /numbers/orders returns, minus customerId at both levels: a sub-reseller's own customers are not this account's to join.

Authorization

apiKey
headerAuthorizationBearer <token>

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

Path Parameters

id*string

Query Parameters

limit?integer

How many to return

Range1 <= value <= 100
Default25
cursor?string

nextCursor from the previous page

Response Body

Success

application/json
  1. response

Success

data*array<>
nextCursor*|

Pass as cursor for the next page. null on the last page

total*integer

How many match across every page

Range0 <= value
curl -X GET "https://example.com/v1/sub-resellers/rsl_01K6XJ4Q8ZT3M9R5V2B7WDHNCA/orders"
{  "data": [    {      "id": "ord_01K6XJ4Q8ZT3M9R5V2B7WDHNCA",      "status": "completed",      "country": "US",      "product": "any_service",      "service": null,      "duration": "30d",      "quantity": 1,      "fulfilledCount": 1,      "autoRenew": true,      "unitPrice": 1200,      "totalPrice": 1200,      "currency": "USD",      "failure": null,      "numbers": [        {          "id": "num_01K6XJ4Q8ZT3M9R5V2B7WDHNCA",          "number": "15550100002",          "country": "US",          "product": "any_service",          "service": null,          "status": "active",          "orderId": "ord_01K6XJ4Q8ZT3M9R5V2B7WDHNCA",          "nickname": "Support line",          "startsAt": "2026-10-07T11:04:31.000Z",          "endsAt": "2026-11-06T11:04:31.000Z",          "autoRenew": true,          "renewDuration": "30d",          "unitPrice": 1200,          "customerPrice": null,          "paidTotal": 1200,          "messageCount": 3,          "cancellableFrom": null,          "createdAt": "2026-10-07T11:04:31.000Z"        }      ],      "actor": {        "kind": "user",        "label": "string"      },      "createdAt": "2026-10-07T11:04:31.000Z",      "updatedAt": "2026-10-07T11:04:31.000Z"    }  ],  "nextCursor": null,  "total": 1}

Price or suspend a sub-reseller PATCH

Sets the price list a sub-reseller is charged from (`null` clears it, so your default list prices it instead), its status, or both. Suspending stops it buying or renewing anything, same as suspending yourself does for your own account.

List a sub-reseller's sales GET

Every purchase and renewal the sub-reseller made, newest first - the same shape as your own `GET /sales`, minus `customerId`: a sub-reseller's own customers are not this account's to join.