List wedges

Parameters21

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.

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

• limitnumber

  Page size.

  20Default 20
• cursorstring

  Opaque pagination token from page.next. Send it unchanged on the same resource, with the same filters, served version and key access. Page size may change between requests. On a cursor 400, restart the scan.

• manufacturerstring

  Manufacturer slug.

• familystring

  Family slug.

• handstring

  Offered hand.

  rhlh
• designationstring

  Heads whose designations includes this value. Each model is returned once. An empty result means no matching published record; an omitted designations field has no published classification.

  womensjunior
• loftstring

  Nominal loft in degrees. The value must occur in the requested collection; otherwise the API returns 400 with that collection’s published lofts. A loft available only in another collection is invalid here. With hand, both must match the same variant: hand=lh&loft=10.5 returns clubs sold left-handed at 10.5 degrees.

• adjustable_hoselstring

  Whether the hosel adjusts.

  truefalse
• release_yearnumber

  Release year, four digits.

• release_year_afternumber

  Inclusive earliest release year, four digits.

• release_year_beforenumber

  Inclusive latest release year, four digits.

• released_afterstring (date)

  Inclusive earliest exact retail date. Matches only records with an exact released date; a record that carries only release_year never matches. A window whose start is later than released_before is 400: the two parameters contradict each other, which is not the same answer as a window that merely matches nothing.

• released_beforestring (date)

  Inclusive latest exact retail date. Matches only records with an exact released date. Equal bounds are a legal one-day window.

• msrp_minnumber

  Inclusive lowest launch MSRP in the market msrp_market names (US when absent), in that currency’s minor units: 50000 is $500 in the US and Y50,000 in JP, since JPY has no minor unit. A club with no launch price in that market never matches. Pro plan: needs the ‘market’ entitlement (403 without it), on any view. Greater than msrp_max is 400.

• msrp_maxnumber

  Inclusive highest launch MSRP in the market msrp_market names (US when absent), in that currency’s minor units: 50000 is $500 in the US and Y50,000 in JP. A club with no launch price in that market never matches. Pro plan: needs the ‘market’ entitlement (403 without it), on any view.

• msrp_marketstring

  ISO 3166-1 alpha-2 market whose intro_price entry msrp_min and msrp_max compare, in its own currency; US when absent. Prices are never converted between currencies. Alone, it keeps the clubs with a launch price in that market. A market the published catalog has no price in is 400, naming the markets it prices. Pro plan: needs the ‘market’ entitlement (403 without it).

• qstring

  Search names, manufacturers, families, and generated aliases. Case and accents are folded. The full-text branch combines tokens with AND, while prefix, alias, and similarity matches can add rows that do not contain every token. A non-empty page does not identify a club; fetch a chosen hit with GET /{resource}/{id-or-slug}. Control characters are invalid.

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.

Responses9

• 200

  A page of wedges.

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

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

One of WedgeCoreList, WedgeExpandedList, MarketClubList. Fields of WedgeCoreList:

• dataWedgeCore[]Required
• pagePageRequired