PricingPrice lists

List price lists

GET
/v1/price-lists

What you charge your customers. Your wallet is always charged the wholesale price; a price list sets what each customer pays you.

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

data*array<>
curl -X GET "https://example.com/v1/price-lists"
{  "data": [    {      "id": "prl_01K6XJ4Q8ZT3M9R5V2B7WDHNCA",      "name": "Agency",      "markupBps": 2000,      "rounding": "99",      "allowBelowCost": true,      "renewals": "follow",      "currency": "USD",      "rate": 1000000,      "isDefault": true,      "rules": [        {          "id": "prr_01K6XJ4Q8ZT3M9R5V2B7WDHNCA",          "product": "number",          "match": "com",          "term": "30d",          "action": "new",          "minQuantity": 10,          "kind": "markup",          "value": 2500        }      ],      "customers": 3,      "actor": {        "kind": "user",        "label": "string"      },      "createdAt": "2026-10-07T11:04:31.000Z",      "updatedAt": "2026-10-07T11:04:31.000Z"    }  ]}