Time to first 200
Create a console account (email + verification code — no password). 50 free test credits, no card. Active Token lives under API Account. It is not a Bearer token. Exchange it first, then call search for free.
Host https://api.golfintelligence.com. Use client credentials. Placeholders only — swap in your Client ID and Active Token from the console.
POST https://api.golfintelligence.com/auth/authenticateToken Content-Type: application/x-www-form-urlencoded grant_type=client_credentials code=YOUR_ACTIVE_TOKEN client_id=YOUR_CLIENT_ID Authorization: Bearer YOUR_ACCESS_TOKEN # after the exchange
Always step one. Power “find a course” without burning credits. Store publicId.
curl -X POST 'https://api.golfintelligence.com/courses/searchCourseGroups' \
-H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
-H 'Content-Type: application/json' \
-d '{"keywords":"YOUR_COURSE","rows":10,"offset":0}'
Illustrative only. Use a real course name from your market. Do not treat sample JSON as a live record.
Flagship call. Scorecard + GPS + metadata. Cache one year per user. Optional per hole: slope image (1) and geohash lie elevation (ask us).
curl 'https://api.golfintelligence.com/courses/getCourseGroupDetail?PublicId=YOUR_PUBLIC_ID' \ -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'
Endpoints
| Method | Path | Credits | Returns |
|---|---|---|---|
| POST | /courses/searchCourseGroups | 0 · free | Course groups matching keywords, country, region, or GPS. Returns publicId. |
| GET | /courses/getCourseGroupScorecard | 1 | Complete scoring scorecard. GPS shapes are not included. |
| GET | /courses/getCourseGroupGPS | 2 | Complete GPS shapes only. Scorecard is not included. |
| GET | /courses/getCourseGroupDetail | 3 | Flagship: scorecard + GPS + metadata in one payload. |
| GET | /greens/getSlopeImage | 1 | Rendered green slope image details, including URL. 900×1620. |
| GET | /greens/getElevationImage | 1 | Rendered green elevation image details, including URL. 900×1620. |
| GET | /holeProfile/getGeoHashElevation | see console | Live lie elevation: geohash cells with GPS altitude. Confirm credits with us. |
Auth: OAuth2 client_credentials · Token URL POST /auth/authenticateToken · Every call Authorization: Bearer <access_token>
Next step
Start with a free test account — 50 credits to download courses, green slope, and elevation. No card. Console login is your email plus a verification code.
Whenever you want a paid plan, Starter is $399/month for 10,000 credits — the lowest paid tier. Email us and we will send the invoice.