---
title: "GetPriceStats"
method: GET
path: "/api/products/price-stats"
---

# GetPriceStats

`GET /api/products/price-stats`

## Request

- Base URL: `https://api.caddence.golf`
- URL: `https://api.caddence.golf/api/products/price-stats`
- Auth: none declared

## Query parameters

- `product_type` string, nullable: Comma-separated product types (the resolved category set)
- `brand` string, nullable: Comma-separated brand spellings (case-insensitive)
- `buckets` string, nullable: Comma-separated price ceilings for 'N under £X' counts
- `max_price` number, nullable: Budget ceiling: only products whose cheapest offer is at or under it

## Response `200`

Request fulfilled, document follows

- BuyablePriceStats
  - `buyable_count` integer, required
  - `brand_count` integer, required
  - `min_price` number, required
  - `max_price` number, required
  - `median_price` number, required
  - `lower_quartile_price` number, nullable
  - `upper_quartile_price` number, nullable
  - `under` object

## Other responses

- `400`: Bad request syntax or unsupported method

---

[API](https://skmtc.dev/caddence/apis/golf-product-api.md) · [All operations](https://skmtc.dev/caddence/apis/golf-product-api/llms.txt) · [OpenAPI document](https://skmtc.dev/caddence/apis/golf-product-api/revisions/adef6c56f7c0?raw)