resellerhq
GuidesAPI reference

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.

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
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    }  ]}

Replace contract prices PUT

Replaces the whole set; send an empty list to clear it. Rules have the same shape as price list rules, with optional dates. `add` and `fixed` values are in the currency of the customer's list. Two rules for the same items and tier must not be in date at the same time.

List sales GET

Every purchase and renewal made for a customer, newest first, with what it cost you and what the customer pays at the prices in force at the time.