Bookings API

Manage flight, hotel, rental car, and package tour bookings.

---

List Bookings

GET /api/v1/bookings

Query Parameters:

Parameter	Type	Description
booking_type	string	FLIGHT, HOTEL, RENTAL_CAR
payment_status	string	UNPAID, PARTIAL, PAID, REFUNDED
pnr	string	Search by PNR
search	string	General search term
booking_date_start	string	YYYY-MM-DD
booking_date_end	string	YYYY-MM-DD
travel_date_start	string	YYYY-MM-DD
travel_date_end	string	YYYY-MM-DD

Also supports pagination parameters.

---

Latest Bookings

Returns the most recent bookings.

GET /api/v1/bookings/latest

---

Get Booking

GET /api/v1/bookings/{id}

---

Create Booking

POST /api/v1/bookings

Request Body:

Field	Type	Required	Description
client_id	uuid	No	Associated client
booking_reference	string	✅ Yes	1–50 chars
pnr	string	No	Max 20 chars
booking_type	string	✅ Yes	FLIGHT, HOTEL, RENTAL_CAR, PACKAGE
total_amount	float	✅ Yes	>= 0
service_fee	float	✅ Yes	>= 0
total_paid	float	✅ Yes	>= 0
booking_date	string	✅ Yes	YYYY-MM-DD
notes	string	No	Max 1000 chars
commission	number	No	Package tour commission amount
paid_directly_to_supplier	boolean	No	Package tour supplier payment flag
paid_directly_to_agency	boolean	No	Package tour agency payment flag

---

Update Booking

PUT /api/v1/bookings/{id}

Uses the same fields as Create Booking.

---

Delete Booking

DELETE /api/v1/bookings/{id}

---

Mark Booking as Paid

POST /api/v1/bookings/{id}/mark-paid

Request Body:

{
  "bank_account_id": "uuid",
  "payment_date": "YYYY-MM-DD"
}

---

Change Booking Client

PUT /api/v1/bookings/{id}

Request Body:

{
  "client_id": "uuid"
}

---

Export Bookings

Format	Endpoint
CSV	GET /api/v1/bookings/export/csv
XLSX	GET /api/v1/bookings/export/xlsx