Skip to content
Bottle

Get every price a product has

GET
/products/{id}/prices
curl --request GET \
  --url https://example.com/products/019205d1-6e7a-7c3b-9f6e-3a2b1c0d9e8f/prices \
  --cookie bottle.session_token=<bottle.session_token>

The Consumer price, the Trade price (null: trade pays the Consumer price), then one row per price list that is not archived, by name, with the list’s price (null: members pay the Trade price). Each row has its quantity breaks: from so many in one order, every one of them is that price. Who pays what: a customer’s own agreed price, then their price list’s price, then the Trade price for trade customers or the Consumer price for everyone else. Quantity breaks go with whichever price applies. Deposits, rent and delivery have no price table (422).

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
id
required

UUID v7

string format: uuid
Example
019205d1-6e7a-7c3b-9f6e-3a2b1c0d9e8f

UUID v7

Responses

Section titled “Responses”

200

Section titled “200”

The price table

Media typeapplication/json
object
productId
required

UUID v7

string format: uuid
consumer
required
object
unitPrice
required
integer
priceIncludesVat
required
boolean
breaks
required
Array<object>

From this many of the product in one order, every one of them is this unit price (“10 or more: £30.00 each”).

object
fromQuantity
required
integer
>= 2 <= 100000
unitPrice
required
integer
<= 100000000
priceIncludesVat
required
boolean
trade
required
object
unitPrice
required
integer | null
priceIncludesVat
required
boolean
breaks
required
Array<object>

From this many of the product in one order, every one of them is this unit price (“10 or more: £30.00 each”).

object
fromQuantity
required
integer
>= 2 <= 100000
unitPrice
required
integer
<= 100000000
priceIncludesVat
required
boolean
priceLists
required
Array<object>
object
rateSetId
required

UUID v7

string format: uuid
name
required
string
colour
required
string | null
unitPrice
required
integer | null
priceIncludesVat
required
boolean
breaks
required
Array<object>

From this many of the product in one order, every one of them is this unit price (“10 or more: £30.00 each”).

object
fromQuantity
required
integer
>= 2 <= 100000
unitPrice
required
integer
<= 100000000
priceIncludesVat
required
boolean
Example
{
  "productId": "019205d1-6e7a-7c3b-9f6e-3a2b1c0d9e8f",
  "priceLists": [
    {
      "rateSetId": "019205d1-6e7a-7c3b-9f6e-3a2b1c0d9e8f"
    }
  ]
}

401

Section titled “401”

Not signed in

Media typeapplication/json
object
error
required
string
message
required
string
Example
{
  "error": "not_found",
  "message": "Customer not found"
}

403

Section titled “403”

Not a member, or without the permission this needs

Media typeapplication/json
object
error
required
string
message
required
string
Example
{
  "error": "not_found",
  "message": "Customer not found"
}

404

Section titled “404”

No such product

Media typeapplication/json
object
error
required
string
message
required
string
Example
{
  "error": "not_found",
  "message": "Customer not found"
}

422

Section titled “422”

A deposit, rent or delivery, which has no price table

Media typeapplication/json
object
error
required
string
message
required
string
Example
{
  "error": "not_found",
  "message": "Customer not found"
}