Prices

GET /prices

Returns the entries on your price list, with your discount terms already applied where eligible. Each element of the response array is one priced SKU.

Authentication

Required. Bearer token from /auth/token.

Request

No query parameters, path parameters, or request body. The response is scoped to your customer record automatically.

Example

GET /prices HTTP/1.1
Host: api.kiss.example.com
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
Accept: application/json

Response

200 OK with a JSON array of Product Price entries.

Example response

[
  {
    "PriceListCode": "EUR-WHOLESALE",
    "PriceListName": "EUR Wholesale 2026",
    "CurrencyCode": "EUR",
    "SKU": "DRAC001",
    "PriceExclVAT": 19.9500,
    "MOQ": 12,
    "OrderMultiple": 12
  },
  {
    "PriceListCode": "EUR-WHOLESALE",
    "PriceListName": "EUR Wholesale 2026",
    "CurrencyCode": "EUR",
    "SKU": "FANG001",
    "PriceExclVAT": 2.4500,
    "MOQ": 24,
    "OrderMultiple": 12
  }
]

Field meanings

Field	Meaning
PriceListCode	Identifier for your assigned price list. The same value appears in every row.
PriceListName	Display name of the price list.
CurrencyCode	ISO 4217 currency code (e.g. EUR, GBP, USD).
SKU	The product code this price applies to.
PriceExclVAT	Net unit price ex‑VAT, with your discount applied where eligible (rounded to 4 decimal places).
MOQ	Minimum order quantity for this SKU.
OrderMultiple	Order increment — quantities must be a multiple of this value.

How discounts work

If your customer record has a discount percentage, it is automatically applied to each price-list entry that is marked as discount-eligible. The PriceExclVAT you receive is the final net price; you do not need to apply the discount yourself.

Some entries (for example, promotional or already-discounted SKUs) may not be marked as discount-eligible on the underlying price list. Those prices are returned unchanged. The response does not include the discount-eligibility flag itself.

When to use /prices vs. /products

• /prices is faster and lighter. Use it when you only need price data — for example, to update your e‑commerce site overnight.
• /products includes the same price information nested inside each product (in the ProductPrices array), alongside descriptive fields, images, and dimensions. Use it when you need the full product detail.

The two endpoints are guaranteed to be consistent — they're derived from the same underlying source.

Pagination

This endpoint does not paginate. All entries in your price list are returned in a single response.

Status codes

Status	Cause
200	Success.
401	Missing, malformed, or expired bearer token.
404	Your customer record could not be found. Body: { "error": "Customer not found." }
429	Rate limited — see Rate limits.

Related endpoints

• GET /products — full product catalogue including these prices.
• GET /stock — current stock for the priced SKUs.