APIPrice tier

Get a price tier

GET
/public/v1/price-tiers/{id}

Get a single price tier by id, with its conditions resolved into the referenced products, categories, customers, and menus. Returns 404 for an unknown or soft-deleted tier, and 403 for one your team restrictions hide.

Required permission: settings_permissions_price_tiers.

Authorization

Bearer
headerAuthorizationBearer <token>

API token generated in Distru (Settings → Distru API). Send it on every request as Authorization: Bearer YOUR_API_TOKEN.

Path Parameters

id*string

Price tier ID, as returned by the list and upsert endpoints.

Response Body

A single price tier

*/*
  1. response

A single price tier

data?

A price tier lowers the price of a single sales order item when the item meets the tier's conditions. It is applied per order item, not at the order level.

Example Request
curl -X GET 'https://app.distru.com/public/v1/price-tiers/843fbbae-5192-4ed6-8e8d-06b48138710d'
Example Response
{  "data": {    "conditions": {      "min_quantity": {        "quantity": "10",        "unit_type": {          "id": "00000000-0000-0000-0000-000000352d1e",          "name": "Unit Type 72"        }      },      "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": [        {          "id": "00000000-0000-0000-0000-0000000003d3",          "name": "Comp Rel Group 32"        }      ],      "one_of_company_relationship_groups": [        {          "id": "00000000-0000-0000-0000-0000000003d3",          "name": "Comp Rel Group 32"        }      ],      "one_of_product_brands": [],      "one_of_product_categories": [        {          "id": "00000000-0000-0000-0000-00000001c167",          "name": "Some category 479",          "official_product_category_id": "OTHER"        }      ],      "one_of_product_groups": [],      "one_of_product_subcategories": [],      "one_of_product_tags": [        {          "id": "00000000-0000-0000-0000-000000000b26",          "name": "Some tag 45"        }      ],      "one_of_products": [],      "total_thc_percentage_range": {        "max": "20.0",        "min": "5.0"      }    },    "creator": {      "banned": false,      "deleted_at": null,      "email": "[email protected]",      "full_name": "FirstName5492 LastName5493",      "id": "00000000-0000-0000-0000-00000005a54b",      "inserted_datetime": "2026-11-06T08:18:38.756032Z",      "role": {        "id": "00000000-0000-0000-0000-00000005c98c",        "name": "Admin 2792"      },      "updated_datetime": "2026-11-06T08:18:38.756032Z"    },    "current_version_id": "00000000-0000-0000-0000-000000000d65",    "external_name": null,    "id": "2a8c6417-9069-46c7-9b15-dee24ddbb843",    "inserted_datetime": "2026-11-06T08:18:38.759625Z",    "is_flat": false,    "menu_mode": "SPECIFIC",    "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": [      {        "id": "00000000-0000-0000-0000-000000001e4c",        "menu_id": "00000000-0000-0000-0000-000000001e4c",        "menu_name": "Menu 191",        "name": "Menu 191"      }    ],    "name": "VIP Flower",    "owner": null,    "percent": null,    "price": "1",    "price_or_percent": "PRICE",    "updated_datetime": "2026-11-06T08:18:38.762079Z",    "valid_from_datetime": null,    "valid_until_datetime": null  }}