PricingPrice lists

Quote customer prices

POST
/v1/price-lists/quote

Works out what a customer, or anyone on a list, pays for items at the wholesale prices given. Nothing is bought. With neither a customer nor a list, the default list. A customer's contract prices count; prices fixed on single items do not, since no item is named. A promotion everyone on the list gets is counted without asking; send coupon to see what the promotion behind a code would do. A coupon that cannot be used is simply not applied.

Authorization

apiKey
headerAuthorizationBearer <token>

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

Request Body

application/json
  1. body
customerId?string
priceListId?string
coupon?string

A coupon code, unlocking the promotion it belongs to

Length1 <= length <= 40
items*array<>
Items1 <= items <= 200

Response Body

Success

application/json
  1. response

Success

priceListId*|

The list the prices came from

data*array<>
curl -X POST "https://example.com/v1/price-lists/quote" \  -H "Content-Type: application/json" \  -d '{    "items": [      {        "product": "number",        "cost": 1440      }    ]  }'
{  "priceListId": "prl_01K6XJ4Q8ZT3M9R5V2B7WDHNCA",  "data": [    {      "cost": 1440,      "price": 1440,      "currency": "USD",      "priceUsd": 1440,      "ruleId": "prr_01K6XJ4Q8ZT3M9R5V2B7WDHNCA",      "level": "override",      "floored": true,      "normalPrice": 1440,      "discount": 1440,      "promotion": {        "id": "prm_01K6XJ4Q8ZT3M9R5V2B7WDHNCA",        "code": "LAUNCH25",        "endsAt": "2026-11-01T00:00:00.000Z"      }    }  ]}