GET
/courses/:id
Retrieve detailed information for a single golf course, including tee box data.
Available on all plans.
Path Parameters
| Parameter | Type | Description |
|---|---|---|
| id | integer | The course_id from the list courses response |
Example Request
bash
curl "https://golfly.dev/api/v1/courses/7072" \
-H "x-api-key: gf_your_api_key"Response
json
{
"data": {
"course_id": 7072,
"name": "#1 at Ponkapoag Golf Club",
"address": "2167 Washington St",
"city": "Canton",
"state": "Massachusetts",
"latitude": 42.2021997889,
"longitude": -71.1126962275,
"rating": "2.3",
"num_reviews": 156,
"holes": 18,
"par": "72",
"length_yards": 6742,
"slope": "128",
"year_built": 1933,
"architects": "Donald Ross",
"tee_data": [
{
"name": "Black",
"par": "72",
"length": "6742 yards",
"slope": "130"
},
{
"name": "Blue",
"par": "72",
"length": "6508 yards",
"slope": "128"
},
{
"name": "White",
"par": "72",
"length": "6147 yards",
"slope": "124"
}
]
}
}Response Fields
Includes all fields from List Courses, plus:
| Field | Type | Description |
|---|---|---|
| slope | string | Course slope rating |
| year_built | integer | Year course was established |
| tee_data | array | Array of tee box information |
Tee Data Object
| Field | Type | Description |
|---|---|---|
| name | string | Tee name (Black, Blue, White, etc.) |
| par | string | Par from this tee |
| length | string | Total length (e.g., "6742 yards") |
| slope | string | Slope rating from this tee |
Errors
404
course_not_foundThe specified course ID does not exist. Verify the ID using the List Courses endpoint.