Store stable IDs
Use a club's clb_ ID for joins and its slug for readable links. Both resolve on the detail route. A historical slug redirects to the current slug.
Variant var_ IDs identify configurations within a model. Metalwoods use loft, hand and market; irons use designation, hand and market; wedges use loft, bounce, grind, hand and market; putters use hand, neck, length and market. Read the resource schema for the fields returned.
Select a response version
API discovery reports the supported version and retired dates. The current version is 2026-10-02. Omit Golfapi-Version or send that date explicitly:
curl 'https://api.golfapi.dev/drivers?limit=1' \
-H "Authorization: Bearer $GOLFDEV_API_KEY" \
-H 'Golfapi-Version: 2026-10-02'
Run export GOLFDEV_API_KEY='sk_test_…' with your key in the same terminal first. Leave $GOLFDEV_API_KEY as written; the shell replaces it with your key. How to set your key
Other dates return 400. A key's historical pin does not preserve an old response shape. Read Golfapi-Version on the response; a response version is not a historical catalog snapshot.
Ignore unfamiliar response fields and handle omitted optional values explicitly. See the changelog for changes and handling responses for caching.