Mini Drivers

Fetch a mini driver's hosel context

GET/mini-drivers/{ref}/hosel

Read the club’s hosel connection and applicable setting charts. Requires the club resource and club-builder entitlements. Returns 503 when no hosel context or signed hosel catalog is published. Unknown query parameters are ignored on this route.

Parameters5

Path

  • refstringRequired

    A returned clb_ id or a current or historical mini driver slug.

Query

  • handstring

    Narrow to one hand.

    rhlh
  • marketstring

    Narrow scopes to one market.

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

    The club’s hosel context, narrowed to the requested scope.

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

  • club_idstringRequired
  • slugstringRequired
  • resourcestringRequired
    driversmini-driversfairway-woodshybrids
  • connection_typestringRequired
    adapterbonded
  • scopesHoselScope[]Required
  • urlstring (uri)Required
  • _linksobjectRequired
  • system_idstring
  • adjustableboolean
  • chartsHoselChart[]
  • standard_settingobject

This page as Markdown