Fetch one iron

Parameters6

Path

• refstringRequired

  A returned clb_ id or a current or historical iron slug.

Query

• viewstring

  Response document: core, expanded or market. Core is the default unless fields selects another document. The legacy token basic is accepted as core. Expanded requires club-builder (Enterprise); Market requires market (Pro plan). Missing access returns 403. Read Golfapi-View for the document served.

  coreexpandedmarket
• fieldsstring

  Comma-separated top-level fields from one response document. id is always returned. Without an explicit view, a Club-builder field selects expanded and intro_price selects market. Missing club-builder or market access returns 403; market (intro_price) needs the Pro plan. An unknown field, a field outside an explicit view, or a selection mixing Club-builder and Market fields returns 400.

• variantsstring

  Filter variants by hand or nominal loft in Core or Club-builder documents. Market carries no variants.

  allDefault all

Headers

• Golfapi-Versionstring (date)

  API version. 2026-10-02 is the only version served, and the default when the header is omitted. Any other date is 400, including the retired versions GET / lists under version.retired. A malformed date is 400.

  2026-10-02Default 2026-10-02
• If-None-Matchstring

  ETag retained for this exact representation URL and version. A 304 is not charged against the rate limit, and its RateLimit-Remaining names the budget after that refund.

Responses11

• 200

  One iron.

• 301

  A historical slug redirects to the canonical URL. Retain the query string and the same-origin auth and version headers. Live example: GET /drivers/g440-max-2025-driver redirects to /drivers/g440-max-driver.

• 304

  Unchanged representation, no response body. Quota refunded after response.

• 400

  Invalid recognized input or projected field.

• 401

  Missing, malformed, unknown, or revoked key.

• 403

  Resource/capability not granted.

• 404

  Referenced record not found.

• 405

  A routed path reached by a method other than GET or OPTIONS.

• 429

  Rate limit reached. 60 requests per 60-second wall-clock window by default; RateLimit-Limit carries this key’s actual cap. Honor Retry-After, which equals RateLimit-Reset.

• 500

  Server fault.

• 503

  Required representation or schema unavailable; honor Retry-After.

Response schema14 fields

One of IronCore, IronExpanded, MarketClub. Fields of IronCore:

• idstringRequired
• slugstring
• namestring
• club_typestring

  The resource this club belongs to: driver, mini-driver, fairway-wood, hybrid, iron (a set), wedge or putter.

  drivermini-driverfairway-woodhybridironwedgeputter
• summarystring

  One sentence naming the club, its maker, introduction year, club type and family. Built from this document’s fields at each catalog build. Contains no specifications and no performance or suitability claims.

• manufacturerNamedEntity
• familyNamedEntity
• release_yearnumber

  The year the manufacturer released this head. Present on every club.

• releasedstring (date)

  First US retail availability, as an exact date. Absent when only release_year is known.

• handsstring[]

  Available hands, ordered rh then lh.

• ironsIronHeadCore[]

  Per-iron loft and lie.

• variantsIronVariant[]

  One entry per designation, hand and market the record names.

• urlstring (uri)

  Canonical club URL.

• updated_atstring (date-time)

  When this response document last changed. Compare within the same view when refreshing a stored catalog; there is no updated_after filter.