Endpoints

Booking Hooks

Booking Hooks (14-Day Reservation Holds)

Booking hooks allow agencies to secure a tee time without immediate payment. The hold lasts up to 14 days and must be confirmed before the tee time date.

Create a Booking Hook

Code
 
POST /bookings/hooks

Creates a 14-day reservation hold on a tee time.

Request Body

Code
 
{
  "courseId": "abc123def456",
  "date": "2026-08-15",
  "teeTime": "09:00",
  "players": 4,
  "leadPlayer": {
    "firstName": "Michael",
    "lastName": "Rodriguez",
    "email": "[email protected]"
  },
  "agencyBookingReference": "TRV-2026-HOLD-001"
}

Response (201 Created)

Code
 
{
  "data": {
    "id": "hook_abc123",
    "status": "held",
    "courseId": "abc123def456",
    "date": "2026-08-15",
    "teeTime": "09:00",
    "players": 4,
    "expiresAt": "2026-08-01T09:00:00Z",
    "createdAt": "2026-07-18T14:22:33Z"
  }
}

Confirm a Booking Hook

Code
 
POST /bookings/hooks/{id}/confirm

Converts a reservation hold into a confirmed booking.

Parameter	Type	Description
id	string	Booking hook ID

Response

Returns a confirmed booking object (same structure as POST /bookings response).

Cancel a Booking Hook

Code
 
DELETE /bookings/hooks/{id}

Releases the reservation hold. The tee time becomes available again.

Parameter	Type	Description
id	string	Booking hook ID