Endpoints

Tee Time Availability

Tee Time Availability

This endpoint provides available tee times for a specific golf course on a selected date.

Check Tee Time Availability

Code
 
GET /courses/{courseId}/tee-times

Retrieves available tee times for booking on a specific date.

Path Parameters

Parameter	Type	Description
courseId	string	ID of the course to check

Query Parameters

Parameter	Type	Description
date	string	Date to check availability (YYYY-MM-DD) (required)
players	integer	Number of players (1-4) (default: 4)
earliestTime	string	Filter for tee times after this time (HH) (optional)
latestTime	string	Filter for tee times before this time (HH) (optional)

Response

Code
 
{
  "courseId": "course_123",
  "courseName": "Marbella Golf Country Club",
  "date": "2023-07-15",
  "dayType": "weekend",
  "isOnline": true,
  "availableTimes": [
    {
      "time": "07:30",
      "available": 4,
      "pricing": {
        "currency": "EUR",
        "greenFee": 105.00,
        "totalAmount": 420.00,
        "priceType": "standard"
      }
    },
    {
      "time": "07:40",
      "available": 4,
      "pricing": {
        "currency": "EUR",
        "greenFee": 105.00,
        "totalAmount": 420.00,
        "priceType": "standard"
      }
    },
    {
      "time": "10:20",
      "available": 2,
      "pricing": {
        "currency": "EUR",
        "greenFee": 105.00,
        "totalAmount": 210.00,
        "priceType": "standard"
      }
    },
    {
      "time": "14:30",
      "available": 4,
      "pricing": {
        "currency": "EUR",
        "greenFee": 75.00,
        "totalAmount": 300.00,
        "priceType": "twilight"
      }
    }
  ],
  "additionalFees": [
    {
      "name": "Golf Cart",
      "price": 40.00,
      "unit": "per_cart",
      "isOptional": true
    }
  ],
  "timeSlots": {
    "firstAvailable": "07:30",
    "lastAvailable": "16:10",
    "twilightStart": "14:00"
  }
}

For offline booking courses, a simplified response is provided:

Code
 
{
  "courseId": "course_456",
  "courseName": "Ocean View Golf Club",
  "date": "2023-07-15",
  "isOnline": false,
  "bookingMessage": "This course requires manual booking. Please provide your preferred tee time and we will check availability with the course.",
  "approximatePricing": {
    "currency": "EUR",
    "estimatedGreenFee": 95.00,
    "priceAccuracy": "estimated"
  },
  "offlineBookingContact": {
    "email": "[email protected]",
    "phone": "+1 (555) 123-4567",
    "responseTime": "within 24 hours"
  }
}

Check Multiple Day Availability

Code
 
GET /courses/{courseId}/availability

Checks availability across multiple days to find the first available day with tee times.

Path Parameters

Parameter	Type	Description
courseId	string	ID of the course to check

Query Parameters

Parameter	Type	Description
startDate	string	Start date for availability check (YYYY-MM-DD) (required)
endDate	string	End date for availability check (YYYY-MM-DD) (required)
players	integer	Number of players (1-4) (default: 4)
timeRange	string	Preferred time range (morning, afternoon, all) (default: all)

Response

Code
 
{
  "courseId": "course_123",
  "courseName": "Marbella Golf Country Club",
  "availabilityResults": [
    {
      "date": "2023-07-15",
      "dayOfWeek": "Saturday",
      "hasAvailability": true,
      "availableSlots": 8,
      "firstAvailableTime": "07:30",
      "lastAvailableTime": "14:30",
      "lowestPrice": 75.00,
      "currency": "EUR"
    },
    {
      "date": "2023-07-16",
      "dayOfWeek": "Sunday",
      "hasAvailability": true,
      "availableSlots": 12,
      "firstAvailableTime": "08:00",
      "lastAvailableTime": "15:20",
      "lowestPrice": 75.00,
      "currency": "EUR"
    },
    {
      "date": "2023-07-17",
      "dayOfWeek": "Monday",
      "hasAvailability": true,
      "availableSlots": 24,
      "firstAvailableTime": "07:00",
      "lastAvailableTime": "16:00",
      "lowestPrice": 65.00,
      "currency": "EUR"
    }
  ],
  "bestAvailability": {
    "date": "2023-07-17",
    "dayOfWeek": "Monday",
    "availableSlots": 24,
    "lowestPrice": 65.00
  }
}

Real-time Availability

Tee time data is retrieved in real-time from our integrated courses. For offline booking courses, availability must be checked manually.

Hold a Tee Time

Code
 
POST /courses/{courseId}/hold-tee-time

Temporarily holds a tee time for up to 15 minutes while the booking is being completed.

Path Parameters

Parameter	Type	Description
courseId	string	ID of the course

Request Body

Code
 
{
  "date": "2023-07-15",
  "time": "07:30",
  "players": 4
}

Response

Code
 
{
  "holdId": "hold_789",
  "courseId": "course_123",
  "date": "2023-07-15",
  "time": "07:30",
  "players": 4,
  "holdExpiration": "2023-06-01T14:37:33Z",
  "pricing": {
    "currency": "EUR",
    "greenFee": 105.00,
    "totalAmount": 420.00
  }
}