Create a price list
Your first list becomes the default for every customer.
apiKeyAuthorizationBearer <token>An API key from the Developers page. rhq_test_ keys reach the sandbox, rhq_live_ keys the live side.
application/json- body
name*string1 <= length <= 80markupBps?integerMarkup over wholesale for anything no rule covers, in basis points
0 <= value <= 10000000rounding?string99 and 00 round worked-out prices up to the next amount ending that way
"none""99""none""00"allowBelowCost?booleanfalserenewals?stringfollow prices each renewal from the list as it is then; hold charges what the customer last paid for that item
"follow""follow""hold"currency?stringThe currency customers on this list are charged in
^[A-Z]{3}$"USD"rate?integerHow much of currency one US dollar buys, in millionths. Needed for any currency but USD
10000 <= value <= 100000000000isDefault?booleanrules?array<>items <= 200[]Created
application/json- response
Created
id*stringname*string1 <= length <= 80markupBps*integerMarkup over wholesale for anything no rule covers, in basis points
0 <= value <= 1000000rounding*string99 and 00 round worked-out prices up to the next amount ending that way
"99""none""00"allowBelowCost*booleanFalse raises any price that would sit under wholesale up to wholesale
renewals*stringfollow prices each renewal from the list as it is then; hold charges what the customer last paid for that item
"follow""hold"currency*stringThe currency customers on this list are charged in
^[A-Z]{3}$rate*integerHow much of the currency one US dollar buys, in millionths: 920000 is 0.92. Always 1000000 for USD
isDefault*booleanThe list for customers with none of their own
rules*array<>customers*integerHow many customers are on this list
actor*|Who created or last updated this list
createdAt*stringdate-timeupdatedAt*stringdate-timecurl -X POST "https://example.com/v1/price-lists" \ -H "Content-Type: application/json" \ -d '{ "name": "Agency" }'{ "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"}