Get a single price list with its entries

Returns the price-list metadata plus every entry on it. Use this when mirroring prices into an external system — partners who only care about metadata should use the list endpoint instead.

supplierId on each entry is null when the entry is the shared (per-variant) price, or the prefixed supplier id when it’s scoped. The hidden Default supplier is filtered out — entries Default-scoped internally surface as null.

GET/api/v1/price-lists/{id}

Authorization

AuthorizationBearer token (bloomcount_...) · headerrequired

Path parameters

idstringrequired

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.

Responses

200OK

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

entriesobject[]required

Every priced row on this price list. The shape matches what `POST /api/v1/price-lists` accepts so you can round-trip prices through your system.

Show properties

Array of object

entryIdstringrequired

variantIdstringrequired

supplierIdstring | null

`null` for the shared (per-variant) price; otherwise the prefixed supplier id when the price is scoped to a single supplier. The hidden Default supplier is filtered out — entries Default-scoped internally surface as `null`.

priceExclTaxnumber<float>required

pricingMethodstring | null

Allowed:stempack

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

404The requested resource doesn't exist or belongs to a different tenant.

errorstringrequired

422Request body or arguments failed validation.

errorstringrequired

429Per-minute rate limit (60/min) or per-month cap exceeded.

errorstringrequired

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

Bearer token (bloomcount_...)Remember on this deviceInclude my values in samples

Parameters

fieldsqueryComma-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.idpath*

Request

curl -X GET "https://app.bloomcount.com/api/v1/price-lists/pl_4q9z3m8b7c2x6n1t5v0w4y8r" \
  -H "Authorization: Bearer YOUR_TOKEN"

const response = await fetch("https://app.bloomcount.com/api/v1/price-lists/pl_4q9z3m8b7c2x6n1t5v0w4y8r", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN"
  }
});

import requests

response = requests.get(
    "https://app.bloomcount.com/api/v1/price-lists/pl_4q9z3m8b7c2x6n1t5v0w4y8r",
    headers={
        "Authorization": "Bearer YOUR_TOKEN"
    },
)

Response

{
  "priceListId": "pl_4q9z3m8b7c2x6n1t5v0w4y8r",
  "name": "April supplier prices",
  "description": "Weekly cost upload from primary wholesaler.",
  "date": "2026-04-29",
  "productType": "flower",
  "defaultMarkupMultiplier": 2.5,
  "taxGroupId": "tax_x7c4d8m2k9n1q5r6t3v8w2y4z",
  "taxExempt": false,
  "entries": [
    {
      "entryId": "pe_51a2b3c4d5e6f7g8h9i0j1k",
      "variantId": "var_h299x7tcqe8rnv4mz12k6yp",
      "supplierId": "sup_77p3v2k6m4t1r5z9c8w0y7b3",
      "priceExclTax": 1.5,
      "pricingMethod": "stem"
    }
  ]
}

{
  "error": "string"
}

{
  "error": "string"
}

{
  "error": "string"
}

{
  "error": "string"
}

{
  "error": "string"
}