---
title: "Search and filter club heads"
method: GET
path: "/v1/catalog/clubs"
tags: ["Catalog"]
---

# Search and filter club heads

`GET /v1/catalog/clubs`

## Request

- Base URL: `https://api.eldrick.com`
- URL: `https://api.eldrick.com/v1/catalog/clubs`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://api.eldrick.com/oauth/authorize`, token URL `https://api.eldrick.com/oauth/token`, scopes: `fittings:read`)

Free (no fitting quota), read-only. Same as the search_clubs MCP tool.

## Query parameters

- `clubType` 'driver' | 'fairway' | 'hybrid' | 'iron' | 'wedge'
- `brand` string
- `category` string
- `minPrice` number
- `maxPrice` number
- `q` string
- `hand` 'right' | 'left'
- `sort` 'popular' | 'price_low' | 'price_high' | 'name'
- `limit` integer
- `offset` integer

## Response `200`

Matching clubs and facet counts

- object
  - `success` unknown
  - `total` integer
  - `offset` integer
  - `limit` integer
  - `clubs` ClubSummary[]
    - `id` string
    - `name` string
    - `brand` string
    - `clubType` 'driver' | 'fairway' | 'hybrid' | 'iron' | 'wedge'
    - `category` string, nullable
    - `categoryLabel` string, nullable
    - `bias` string, nullable
    - `price` number, nullable: USD; irons are priced per club
    - `pricedPer` 'club' | 'iron'
    - `image` string, nullable
    - `lofts` number[]
    - `adjustable` boolean
    - `handedness` string[]
    - `recommendedLast30Days` integer
    - `stockShaftOptions` integer
    - `storeUrl` string, uri
  - `facets` object

## Other responses

- `400`: Validation error
- `429`: Rate limited
- `503`: Catalog temporarily unavailable

---

[API](https://skmtc.dev/eldrick/apis/eldrick-golf-fitting-api.md) · [All operations](https://skmtc.dev/eldrick/apis/eldrick-golf-fitting-api/llms.txt) · [OpenAPI document](https://skmtc.dev/eldrick/apis/eldrick-golf-fitting-api/revisions/9469c1821a83?raw)