Filter records
Filters combine with AND within the key's accessible catalog.
curl 'https://api.golfapi.dev/drivers?manufacturer=ping&hand=rh&limit=10' \
-H "Authorization: Bearer $GOLFDEV_API_KEY"
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
The API Reference defines filters and allowed values for each route. Club list and detail routes reject unknown or repeated query parameters; hosel and equipment routes have their own rules.
Select fields
fields= selects top-level fields and retains id. Other fields appear only when requested and published in the selected document.
curl 'https://api.golfapi.dev/drivers?fields=id,name,manufacturer&limit=10' \
-H "Authorization: Bearer $GOLFDEV_API_KEY"
Without an explicit view, a Club-builder field selects Expanded and intro_price Pro selects Market for an entitled key. Missing access returns 403. Fields outside an explicit view, or a selection mixing Club-builder and Market fields, return 400. See views and access.
Follow pagination
The default page size is 20; the maximum is 100. When page.has_more is true, send page.next unchanged as cursor on the same resource. Keep filters, the served version and key access unchanged. Page size can change.
The cursor is a token, not a URL. Keep the origin fixed to https://api.golfapi.dev. Stop on the last page or at your application's request budget. On a cursor 400, restart the scan.