CorebillCorebill
Start for free
Core Resources

Price Lists

Special prices by type of customer (resellers, wholesale...).

Overview

A price list sets the price of each item for the customers that use it: a special price per item, or the base price plus adjustment_percent for the rest. A list applies only to items of its currency. Customers without a list use the General list (the price of each item).

Endpoints

MethodPathPermissionDescription
GET/v1/price-listsreadList price lists
POST/v1/price-listsadminCreate a list (name, currency, adjustment_percent)
GET/v1/price-lists/{id}readRetrieve a list with its special prices
POST/v1/price-lists/{id}adminUpdate a list
DELETE/v1/price-lists/{id}adminDelete a list (its customers go back to General)
POST/v1/price-lists/{id}/pricesadminOne { item_id, price } or many { prices: [{ code, price }] }
GET/v1/customers/{id}/pricesreadResolved price of items for a customer (item_ids)

Set Prices

 1curl -X POST "https://api.corebill.io/v1/price-lists/plst_a1b2/prices" \
 2  -H "Authorization: Bearer sk_live_your_api_key" \
 3  -H "Content-Type: application/json" \
 4  -d '{ "prices": [{ "code": "SKU-001", "price": 20.5 }, { "code": "SKU-002", "price": null }] }'
  • price: null removes the special price; the item then follows the list rule
  • The bulk form returns saved, removed, not_found and invalid (codes)
  • source of a resolved price: special, rule or base
Credit and CollectionQuotes