Retrieves a list of all reservations made by the currently authenticated user. Can be filtered by status.

Retrieves a list of all available cities. If a 'name' query parameter is provided, it searches for locations matching that specific city name.

Creates a new user account. Requires either an email or a phone number.

Verifies the provided OTP and, if valid, returns a JWT access token and user information to complete the login process.

Requests a One-Time Password (OTP) to be sent to the user's registered email or phone number for passwordless login.

Public endpoint to retrieve the full details for a single ticket, including vehicle-specific information and services, before a user commits to booking.

Public endpoint to search for one-way tickets based on criteria like origin, destination, date, and vehicle type. Authentication is not required.

Processes the payment for a reserved booking using the specified payment method (e.g., WALLET, CARD). On success, this finalizes the booking and updates the reservation status to 'PAID'.

Initiates a new two-way reservation for an outgoing and return ticket. Expects an array of two ticket selections. This holds the tickets for 10 minutes, awaiting payment.

Initiates a new one-way reservation for a single selected ticket. This holds the ticket for 10 minutes, awaiting payment.

Allows an authenticated user to submit a report related to a reservation or ticket. The report is then reviewable by an admin.

Updates the seat number for a specific ticket leg within a reservation.

Forcefully cancels a reservation on behalf of a user. The logged-in admin's ID is recorded as the canceller.

Fetches the detailed information for a specific reservation, including ticket details.

Retrieves a list of all reservations with the status 'CANCELLED'.

Retrieves a list of all reports submitted by users.

Fetches a single report by its unique ID.

Retrieves all reports submitted by a specific user, identified by their user ID.

Fetches the full details of a single payment record by its unique ID.

Processes the cancellation of a reservation. This is the final step and is irreversible. It updates the reservation status and refunds the user to their wallet after deducting penalties.

Calculates the penalty fee and total refund amount for cancelling a reservation without actually performing the cancellation. Useful for showing the user the cost beforehand.

Allows an authenticated user to update their own profile information, such as name, city, and contact details.