Home / Docs
Golf Courses API docs
The production REST contract for catalog, coverage, profiles, reviews, and per-course tee-time availability.
| Base URL | https://api.bluedoor.sh/golf-courses/v1 |
| Authentication | x-api-key or Authorization: Bearer |
| Anonymous limit | 1 request/second, burst 10 |
| Free key limit | 5 requests/second, burst 30 |
| Enterprise limit | 50 requests/second, burst 200 |
| OpenAPI | openapi.json |
Endpoints
| Method | Path | Purpose |
|---|---|---|
| GET | /v1/courses | List/filter courses |
| GET | /v1/search | Fuzzy course search |
| GET | /v1/resolve | Resolve name/location or booking URL to a course_id |
| GET | /v1/courses/{id} | Course profile, booking channels, coverage, links |
| GET | /v1/courses/{id}/tee-times | Normalized tee times, prices, occupancy |
| GET | /v1/courses/{id}/availability | Per-day availability rollup |
| GET | /v1/courses/{id}/reviews | Review aggregates and recent rows |
| GET | /v1/coverage | Consumer-altitude coverage rollup |
| GET | /v1/sources | Category-level source provenance |
| GET | /v1/usage | Rate-limit and live-refresh budget status |
Response contract
Successful v1 responses contain data and meta. Errors contain error and meta. Every response includes request, security, CORS, and rate-limit headers.
Get this page with API
Rendered from the bluedoor Golf Courses API. Reproduce it:
GET https://api.bluedoor.sh/golf-courses/v1/JSONGET https://api.bluedoor.sh/golf-courses/v1/usageJSON