Get a list of available origin locations for bookings.

Args:
    provider: The booking provider name (e.g., 'bus', 'mysafari', 'otapp'). Default is 'bus'.

Get a list of available destination locations for a given origin.

Args:
    origin_id: The ID of the origin location.
    provider: The booking provider name. Default is 'bus'.

Search for available trips between an origin and destination on a specific date.

Args:
    origin_name: The name of the origin location (e.g., 'Mwanza').
    destination_name: The name of the destination location (e.g., 'Dodoma').
    travel_date: The travel date in YYYY-MM-DD format.
    provider: The booking provider name. Default is 'bus'.
    adults: Number of adult passengers.
    children: Number of child passengers.

Get the agent's booking history.

Args:
    page: Page number (starts at 1).
    per_page: Items per page (max 100).
    status: Filter by booking status.
    provider: Filter by provider.

Create a new booking.

Args:
    trip_id: The ID of the trip to book.
    passengers: A list of dictionaries representing passengers. Each passenger needs:
        name, phone_number, age_group_id, seat_number, pick_point_id, drop_point_id, 
        gender (M or F), identification_type_id, id_number.
    provider: The provider of the trip (e.g. mysafari).
    origin_id: Optional origin ID.
    destination_id: Optional destination ID.
    travel_date: Optional travel date (YYYY-MM-DD).

Generate a formatted text receipt for a given booking reference.

Args:
    booking_ref: The booking reference ID.
    provider: The provider of the booking.

Initiate a customer push payment request for a booking.

Args:
    booking_id: The ID of the booking to pay for.
    provider: The provider of the booking (e.g. mysafari).
    customer_phone: The phone number of the customer for mobile money push.
    payment_provider: Optional mobile money provider name (e.g. VODACOM, TIGO).