Endpoints

Group Bookings

Group Bookings

For groups of more than 4 players, use the group booking endpoints. Group bookings are processed asynchronously and support advanced features like multi-slot coordination and group pricing.

Create a Group Booking

Code
 
POST /group-bookings

Submits a group booking request for asynchronous processing.

Request Body

Code
 
{
  "courseId": "abc123def456",
  "date": "2026-09-15",
  "preferredTime": "09:00",
  "totalPlayers": 12,
  "leadPlayer": {
    "firstName": "Michael",
    "lastName": "Rodriguez",
    "email": "[email protected]",
    "phone": "+34 600 123 456"
  },
  "agencyBookingReference": "TRV-2026-GRP-001",
  "specialRequests": "3 buggies required"
}

Response (202 Accepted)

Code
 
{
  "data": {
    "id": "grp_abc123",
    "status": "processing",
    "totalPlayers": 12,
    "courseId": "abc123def456",
    "date": "2026-09-15",
    "createdAt": "2026-07-01T10:00:00Z"
  }
}

Get Group Booking Status

Code
 
GET /group-bookings/{id}

Returns the current status and details of a group booking.

Update Group Booking Players

Code
 
PUT /group-bookings/{id}/players

Updates the player list for a group booking.

Find Available Group Slots

Code
 
POST /group-bookings/find-slots

Searches for consecutive tee time slots that can accommodate a group.

Request Body

Code
 
{
  "courseId": "abc123def456",
  "date": "2026-09-15",
  "totalPlayers": 12,
  "preferredStartTime": "09:00"
}

Calculate Group Price

Code
 
POST /group-bookings/calculate-price

Calculates the total price for a group booking including any group discounts.

Request Body

Code
 
{
  "courseId": "abc123def456",
  "date": "2026-09-15",
  "totalPlayers": 12
}

Validate Group Booking

Code
 
POST /group-bookings/validate

Validates a group booking request before submission. Use this to check availability and pricing without creating a booking.