Endpoints

Course Endpoints

Course Endpoints

Search and retrieve golf course information.

List All Courses

Code
 
GET /courses

Returns a paginated list of golf courses with optional filtering.

Query Parameters

Parameter	Type	Description
country	string	Filter by country code (e.g., ES, DE, PT)
region	string	Filter by region ID
holes	integer	Filter by number of holes (9 or 18)
latitude	number	Latitude for geographic search (requires longitude)
longitude	number	Longitude for geographic search (requires latitude)
distance	number	Max distance in km from coordinates (default: 50, max: 500)
geoArea	string	Named geographical area (e.g., 'costa-del-sol', 'algarve')
page	integer	Page number (default: 1)
pageSize	integer	Items per page (default: 20, max: 100)

Response

Code
 
{
  "data": [
    {
      "id": "abc123def456",
      "name": "Marbella Golf Country Club",
      "country": "ES",
      "region": "Andalusia",
      "city": "Marbella",
      "courseType": "resort",
      "holes": 18,
      "isOnline": true,
      "thumbnailUrl": "https://cdn.golfglobe365.com/prod/course/marbella-golf-thumb.jpg",
      "latitude": 36.5150,
      "longitude": -4.8847
    }
  ],
  "meta": {
    "pagination": {
      "page": 1,
      "pageSize": 20,
      "totalItems": 325,
      "totalPages": 17
    }
  }
}

Get Course Details

Code
 
GET /courses/{id}

Returns detailed information about a specific golf course.

Path Parameters

Parameter	Type	Description
id	string	Course document ID or booking code

Response

Code
 
{
  "data": {
    "id": "abc123def456",
    "name": "Marbella Golf Country Club",
    "country": "ES",
    "region": "Andalusia",
    "city": "Marbella",
    "address": "Calle del Golf 1, 29603 Marbella",
    "courseType": "resort",
    "holes": 18,
    "par": 72,
    "isOnline": true,
    "latitude": 36.5150,
    "longitude": -4.8847,
    "facilities": [
      "driving_range",
      "putting_green",
      "pro_shop",
      "buggy_rental",
      "club_rental",
      "restaurant"
    ],
    "thumbnailUrl": "https://cdn.golfglobe365.com/prod/course/marbella-golf-thumb.jpg",
    "coverImageUrl": "https://cdn.golfglobe365.com/prod/course/marbella-golf-cover.jpg"
  }
}

Get Course Pricing

Code
 
GET /courses/{id}/pricing

See the Pricing section for full documentation.

Get Course Terms

Code
 
GET /courses/{id}/terms

Returns the resolved cancellation policy and booking terms for a course. Platform default policies apply unless the course has a specific override.

Response

Code
 
{
  "data": {
    "courseId": "abc123def456",
    "courseName": "Marbella Golf Country Club",
    "cancellationPolicy": {
      "tiers": [
        { "hoursBeforeTeeTime": 72, "refundPercent": 100, "label": "Free cancellation" },
        { "hoursBeforeTeeTime": 24, "refundPercent": 50, "label": "50% refund" },
        { "hoursBeforeTeeTime": 0, "refundPercent": 0, "label": "No refund" }
      ],
      "policyText": null,
      "source": "platform"
    },
    "bookingTerms": {
      "maxPlayersPerBooking": 4,
      "maxDaysInAdvance": 400,
      "modificationAllowed": true,
      "modificationCutoffHours": 24,
      "selfServiceCancellationCutoffHours": 24
    }
  }
}