Fetch one hybrid

Parameters6

Path

• refstringRequired

  A returned clb_ id or a current or historical hybrid 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.

Responses12

• 200

  One club.

• 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.

• 410

  The club was published and then removed from the catalog. Ids are never reused; GET /changes lists removals.

• 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 schema19 fields

One of CoreClub, ExpandedClub, MarketClub. Fields of CoreClub:

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

  Exact first retail availability date for the recorded launch market. Omitted when only release_year is published.

• lofts_degnumber[]

  Sorted union of offered nominal lofts.

• handsstring[]

  Available hands, ordered rh then lh.

• volume_ccnumber

  Head volume in cc. Mirrors head.volume_cc. Present on every driver, mini-driver and hybrid. A fairway wood omits it when its manufacturer states no model head volume.

• adjustable_hoselboolean
• headClubHead

  volume_cc is omitted when the manufacturer states no model head volume, and head is omitted when no head value is known. On fairway woods and hybrids it is the lowest-loft head’s volume when the manufacturer states only per-head volumes.

• hosel_summaryobject

  Consumer-facing hosel summary. adjustable is present whenever the object is. The named hosel system is Club-builder (view=expanded).

• variantsCoreVariant[]

  One entry per loft, hand and market combination.

• designationsstring[]

  The manufacturer’s labels on this head and its builds: the union of the head’s own designation and every build’s, ordered womens then junior. Absent when empty. Absent designations means no label is published, not “not a women’s club”: a head without the field may still be sold in a women’s or junior build that no published record names yet. womens is the manufacturer’s label, not a statement about who should play the club.

• 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.