Get Supplier Price List Metadata

GET 
/api/suppliers/:supplier/price-list/meta

Everything needed to drive the price list's pickers, fetched once rather than on every page:

• tiers.sell / tiers.cost — selectable retail and supplier pricing tiers with their currency codes
• selected_tiers — the tier ids, names and currencies actually resolved for this request
• brands — the distinct product brands this supplier supplies (id + name), for the brand filter
• columns — the full column catalogue: key, human label, and default (whether the column is shown/exported unless the caller overrides it)

The columns[].key values are the same tokens accepted by the export endpoint's columns parameter.

Authentication: Requires Bearer token (scope: suppliers)

Request

Responses

200

OK

Response Headers

Content-Type

401

Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.

403

Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.

404

Not found — no record with the given identifier (or the route does not exist). Verify the ID before retrying.

429

Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.