Skip to content
Bloomcount API
Esc
↑↓navigate↵open⌘Jpreview

List price lists

Cursor-paginated list of every price list for the tenant. Returns metadata only — entries are not included. Use GET /api/v1/price-lists/{id} for the entry rows.

An event quotes from up to three lists at once: one for flowers, one for materials and one for hire, which is why productType matters when picking the list to write an event against.

GET/api/v1/price-lists
Authorization
AuthorizationBearer token (bloomcount_...) · headerrequired
Query parameters
fieldsstring
Comma-separated list of the fields to return, so a caller can ask for the parts of an object it actually uses. A dotted path reaches inside a collection, so `variants.sku` keeps the variants array with only each variant's SKU. The object's own id comes back whether or not it is listed, which keeps a trimmed response addressable. A name that the resource hasn't got returns 422 `unknown_fields:` followed by the names that did not resolve. Omit the parameter for the full object.
limitinteger
min 1 · max 100 · default: 25
cursorstring
productTypestring
Restrict to one product-type bucket (flower / material / hire).
Allowed:flowermaterialhire
Responses
200OK
itemsListedPriceList[]required
Show properties
Array of ListedPriceList
priceListIdstringrequired
namestringrequired
descriptionstringrequired
datestringrequired
productTypestring | null
Filters which products this list prices. - `flower` — fresh-stem variants only. - `material` — sundry variants only. - `hire` — studio-owned hireable variants only. Each entry on a hire price list is the daily fee charged when the line is added to an event; line totals are computed as `dailyFee × days × qty` with the list's tax + markup applied.
Allowed:flowermaterialhire
defaultMarkupMultipliernumber<float> | null
taxGroupIdstring | null
taxExemptboolean | null
isDonebooleanrequired
cursorstring | nullrequired
401Missing or invalid API key, or revoked / expired.
errorstringrequired
403Authenticated, but the key lacks the required scope or the tenant has no API access.
errorstringrequired
422Request body or arguments failed validation.
errorstringrequired
429Per-minute rate limit (60/min) or per-month cap exceeded.
errorstringrequired
Try it
Server
Authorization
Parameters
Request
curl -X GET "https://app.bloomcount.com/api/v1/price-lists" \
  -H "Authorization: Bearer YOUR_TOKEN"
Response
{
  "items": [
    {
      "priceListId": "pl_4q9z3m8b7c2x6n1t5v0w4y8r",
      "name": "April supplier prices",
      "date": "2026-04-29",
      "productType": "flower",
      "defaultMarkupMultiplier": 2.5,
      "taxGroupId": "tax_x7c4d8m2k9n1q5r6t3v8w2y4z",
      "taxExempt": false
    },
    {
      "priceListId": "pl_5r0a4n9c8d3y7o2u6w1x5z9s",
      "name": "2026 Hire Catalogue",
      "date": "2026-05-01",
      "productType": "hire",
      "defaultMarkupMultiplier": 1,
      "taxGroupId": null,
      "taxExempt": false
    }
  ],
  "isDone": true,
  "cursor": null
}