Get price tiers
List the company's price tiers, newest first (by creation time). A price tier lowers the price of a matching sales order item — it applies to an order item only when every one of the tier's populated conditions is met. Soft-deleted tiers are excluded, and so are tiers your team restrictions hide. Tiers outside their active window are still listed; the window only governs whether a tier applies to orders, not whether it appears here.
Filter with company_id (a customer condition), product_ids (a product
condition), or search (substring on the internal name). When several filters are supplied a
tier must satisfy all of them (AND).
Results are paginated. Walk pages by following the response's next_page URL; it is null on
the last page.
Required permission: settings_permissions_price_tiers.
BearerAuthorizationBearer <token>API token generated in Distru (Settings → Distru API). Send it on every request as Authorization: Bearer YOUR_API_TOKEN.
ids[]?array<string>Restrict the result to specific price tiers by ID (the same ID returned as each price tier's id). Repeat the bracketed key once per ID. Unknown IDs simply match nothing; an empty list is treated as no filter. At most 200 IDs may be given.
company_id?stringReturn only tiers that include this customer in a customer condition. The customer's company ID (the id GET /public/v1/companies returns). Matches a tier whose "one of these customers" condition lists this id exactly; tiers with no customer condition, or that only exclude this customer, are not returned.
product_ids[]?array<string>Return only tiers that explicitly list any of these products in their product condition (the same products returned under a tier's conditions.one_of_products). Repeat the bracketed key once per product ID; matches ANY. Tiers with no product condition — all-products tiers, or those scoped by category/brand/group — are not returned, nor are tiers that only exclude these products. A malformed ID is rejected with a 400; an unknown-but-well-formed ID matches nothing; an empty list is no filter. At most 200 IDs.
search?stringCase-insensitive substring match on the tier's internal name. Does not search external_name.
inserted_datetime?stringFilter to price tiers by their creation datetime, given as a comma-separated start,end pair of ISO8601 datetimes (inclusive). Either bound may be omitted for an open-ended range: 2022-07-10T00:00:00Z, matches on or after that instant, ,2022-07-10T00:00:00Z matches on or before it.
updated_datetime?stringFilter to price tiers by their last-updated datetime, given as a comma-separated start,end pair of ISO8601 datetimes (inclusive). Either bound may be omitted for an open-ended range.
owner_ids[]?array<string>Restrict to price tiers owned by any of these Distru users (each tier's owner.id). Repeat the bracketed key once per ID; matches ANY. Unknown IDs match nothing; an empty list is no filter. At most 200 IDs.
page?stringPage selector. Page size is fixed by the server; paginate by following the next_page URL in each response rather than building page selectors yourself — it is null on the last page. next_page uses page[after]=<cursor>, an opaque token marking where the next page resumes; pass it back exactly as given, and only to the endpoint that issued it. This is seek-based, so every page stays fast no matter how deep you page.
A list of price tiers
*/*- response
A collection of price tiers
data?array<>Price Tiers
next_page?stringURL for the next page of results; null when there is no next page
curl -X GET 'https://app.distru.com/public/v1/price-tiers'{ "data": [ { "conditions": { "min_quantity": null, "not_one_of_companies": [], "not_one_of_company_groups": [], "not_one_of_company_relationship_groups": [], "not_one_of_product_brands": [], "not_one_of_product_categories": [], "not_one_of_product_groups": [], "not_one_of_product_subcategories": [], "not_one_of_product_tags": [], "not_one_of_products": [], "one_of_companies": [], "one_of_company_groups": [], "one_of_company_relationship_groups": [], "one_of_product_brands": [], "one_of_product_categories": [], "one_of_product_groups": [], "one_of_product_subcategories": [], "one_of_product_tags": [], "one_of_products": [], "total_thc_percentage_range": null }, "creator": { "banned": false, "deleted_at": null, "email": "[email protected]", "full_name": "FirstName6166 LastName6167", "id": "00000000-0000-0000-0000-00000005a69b", "inserted_datetime": "2026-11-06T08:18:41.062114Z", "role": { "id": "00000000-0000-0000-0000-00000005cae1", "name": "Admin 3133" }, "updated_datetime": "2026-11-06T08:18:41.062114Z" }, "current_version_id": "00000000-0000-0000-0000-000000000d6f", "external_name": null, "id": "da07926c-8ae5-442e-a4a3-8fdff628f829", "inserted_datetime": "2025-01-03T00:00:00.000000Z", "is_flat": false, "menu_mode": "ALL", "menu_promo_card_background_hex": "#9F60FF", "menu_promo_card_emoji": "🎉", "menu_promo_card_text_hex": "#0D1D23", "menu_promo_card_type": "TEXT", "menu_promo_enabled": false, "menus": [], "name": "T3", "owner": null, "percent": null, "price": "1", "price_or_percent": "PRICE", "updated_datetime": "2026-11-06T08:18:41.066819Z", "valid_from_datetime": null, "valid_until_datetime": null }, { "conditions": { "min_quantity": null, "not_one_of_companies": [], "not_one_of_company_groups": [], "not_one_of_company_relationship_groups": [], "not_one_of_product_brands": [], "not_one_of_product_categories": [], "not_one_of_product_groups": [], "not_one_of_product_subcategories": [], "not_one_of_product_tags": [], "not_one_of_products": [], "one_of_companies": [], "one_of_company_groups": [], "one_of_company_relationship_groups": [], "one_of_product_brands": [], "one_of_product_categories": [], "one_of_product_groups": [], "one_of_product_subcategories": [], "one_of_product_tags": [], "one_of_products": [], "total_thc_percentage_range": null }, "creator": { "banned": false, "deleted_at": null, "email": "[email protected]", "full_name": "FirstName6162 LastName6163", "id": "00000000-0000-0000-0000-00000005a699", "inserted_datetime": "2026-11-06T08:18:41.049387Z", "role": { "id": "00000000-0000-0000-0000-00000005cadf", "name": "Admin 3131" }, "updated_datetime": "2026-11-06T08:18:41.049387Z" }, "current_version_id": "00000000-0000-0000-0000-000000000d6e", "external_name": null, "id": "413f9815-e664-4ce9-a7a3-85da4f307ca3", "inserted_datetime": "2025-01-02T00:00:00.000000Z", "is_flat": false, "menu_mode": "ALL", "menu_promo_card_background_hex": "#9F60FF", "menu_promo_card_emoji": "🎉", "menu_promo_card_text_hex": "#0D1D23", "menu_promo_card_type": "TEXT", "menu_promo_enabled": false, "menus": [], "name": "T2", "owner": null, "percent": null, "price": "1", "price_or_percent": "PRICE", "updated_datetime": "2026-11-06T08:18:41.055805Z", "valid_from_datetime": null, "valid_until_datetime": null }, { "conditions": { "min_quantity": null, "not_one_of_companies": [], "not_one_of_company_groups": [], "not_one_of_company_relationship_groups": [], "not_one_of_product_brands": [], "not_one_of_product_categories": [], "not_one_of_product_groups": [], "not_one_of_product_subcategories": [], "not_one_of_product_tags": [], "not_one_of_products": [], "one_of_companies": [], "one_of_company_groups": [], "one_of_company_relationship_groups": [], "one_of_product_brands": [], "one_of_product_categories": [], "one_of_product_groups": [], "one_of_product_subcategories": [], "one_of_product_tags": [], "one_of_products": [], "total_thc_percentage_range": null }, "creator": { "banned": false, "deleted_at": null, "email": "[email protected]", "full_name": "FirstName6160 LastName6161", "id": "00000000-0000-0000-0000-00000005a698", "inserted_datetime": "2026-11-06T08:18:41.034848Z", "role": { "id": "00000000-0000-0000-0000-00000005cade", "name": "Admin 3130" }, "updated_datetime": "2026-11-06T08:18:41.034848Z" }, "current_version_id": "00000000-0000-0000-0000-000000000d6d", "external_name": null, "id": "9db61a44-df7e-4051-ac75-bffdc6b3cf2c", "inserted_datetime": "2025-01-01T00:00:00.000000Z", "is_flat": false, "menu_mode": "ALL", "menu_promo_card_background_hex": "#9F60FF", "menu_promo_card_emoji": "🎉", "menu_promo_card_text_hex": "#0D1D23", "menu_promo_card_type": "TEXT", "menu_promo_enabled": false, "menus": [], "name": "T1", "owner": null, "percent": null, "price": "1", "price_or_percent": "PRICE", "updated_datetime": "2026-11-06T08:18:41.042686Z", "valid_from_datetime": null, "valid_until_datetime": null } ], "next_page": null}