---
title: "GetPriceRankings"
method: GET
path: "/api/products/{product_id}/price-rankings"
---

# GetPriceRankings

`GET /api/products/{product_id}/price-rankings`

## Request

- Base URL: `https://api.caddence.golf`
- URL: `https://api.caddence.golf/api/products/{product_id}/price-rankings`
- Auth: none declared

## Path parameters

- `product_id` string, required

## Response `200`

Request fulfilled, document follows

- PriceRankingsResponse
  - `product_id` string, required: Product ID
  - `product_name` string, nullable: Product name
  - `brand` string, nullable: Product brand
  - `rankings` PriceRanking[], required: Price rankings by retailer
    - `retailer` string, required: Retailer name
    - `price` number, required: Price in GBP
    - `rrp` number, nullable: RRP in GBP
    - `url` string, nullable: Product URL at retailer
    - `rank` integer, required: Price rank (1 = cheapest)
    - `savings_vs_rrp_pct` number, nullable: Savings vs RRP as percentage
  - `cheapest_price` number, nullable: Lowest current price
  - `price_spread` number, nullable: Difference between highest and lowest
  - `retailer_count` integer, required: Number of retailers stocking this product

## 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)