Seat Layout

This method gives the seat details of the user selected bus. Client need to pass the ‘ResultIndex’ in the request and in response, they get the complete seat details of requested bus like how many seats are available, how many seats are reserved for ladies and price details.

Service URL (REST) to be used:
Seat Layout Request
Level Element Format Comments Mandatory
1 ClientId String Unique client identifier assigned to the agency during registration and API onboarding. Used for request authentication and tracking. Mandatory
2 UserName String Authorized API username issued to the agency for authentication and access to bus booking services. Mandatory
3 Password String Secure API password associated with the registered username. Required for request validation and authorization Mandatory
4 TraceId String Unique identifier for identifying every unique search Required for audit purpose from Search Response Mandatory
5 SrdvIndex String Unique internal identifier assigned to the bus result by the API. Required for subsequent booking-related operations. Mandatory
6 ResultIndex String Unique reference identifier for the specific bus search result. Used to identify the selected bus during the booking flow Mandatory
Seat Layout Response
Level Element Format Comments Mandatory
1 Error{} Object Contains error information related to the request processing. This object is returned in both successful and failed responses. Mandatory
1.1 ErrorCode Integer Numeric error code indicating the status of the request. A value of 0 typically indicates successful processing. Mandatory
1.2 ErrorMessage String Contains error description corresponding to ErrorCode. Error Message would be blank in case ErrorCode=0. Mandatory
2 TraceId String Unique identifier for identifying every unique search Required for audit purpose. Mandatory
3 SrdvIndex String Unique internal identifier assigned to the bus result by the API. Required for subsequent booking-related operations. Mandatory
4 ResultIndex String Unique reference identifier for the specific bus search result. Used to identify the selected bus during the booking flow. Mandatory
5 AvailableSeats String Total number of seats currently available for booking on the selected bus service. Mandatory
6 PaxIdRequired Enumeration Indicates whether passenger identification details are required during booking. Possible values: Yes or No. Mandatory
7 Result{} Object Contains detailed information about the available seat. Mandatory
7.1 ColumnNo Integer Seat's column number in the layout grid. Mandatory
7.2 RowNo Integer Seat's row number in the layout grid. Mandatory
7.3 IsLadiesSeat Boolean Indicates if the seat is reserved for ladies.( Value is "true" or "false"). Mandatory
7.4 IsMalesSeat Boolean Indicates if the seat is reserved for males. ( Value is "true" or "false") . Optional
7.5 IsUpper Boolean Shows if the seat is on the upper deck in a sleeper bus.("true" or "false"). Optional
7.6 SeatName String Label or number assigned to the seat (e.g., "1A"). Mandatory
7.7 SeatStatus Boolean "true" means seat is available; "false" means it is booked or not selectable. Mandatory
7.8 ReservedForSocialDistancing Boolean "true" if seat is blocked due to COVID/social distancing guidelines. Optional
7.9 DoubleBirth Boolean "true" if the seat is a double birth (usually in sleeper coaches). Optional
7.10 SeatType String Type of the seat (e.g., Seater, Sleeper, SemiSleeper, etc.) . Mandatory
7.11 Width Integer Indicates how many blocks wide the seat occupies in the layout. Optional
7.12 Price {} Object Contains fare breakdown for the seat, including base fare, taxes, GST, etc. Mandatory
7.12.1 CurrencyCode String The currency in which the fare is quoted (e.g., "INR"). Mandatory
7.12.2 BaseFare String The basic fare of the seat before any taxes or discounts. Mandatory
7.12.3 Tax String Tax applicable on the base fare. Mandatory
7.12.4 Discount Decimal Any discount offered on the seat fare. Optional
7.12.5 PublishedFare String Total fare before discounts ( BaseFare + Tax + Other Charges, if any) . Mandatory
7.12.6 OfferedFare Decimal The final fare offered to the customer after applying discounts. Mandatory
7.12.7 AgentCommission Decimal Commission amount applicable for the agent on this fare. Optional
7.12.8 AgentMarkUp Decimal Additional markup amount added by the agent to the fare. Optional
7.12.9 GstTaxableAmount String The amount on which GST is calculated (usually equals BaseFare). Optional
7.12.10 GSTRate String GST percentage rate applied (e.g., 5%). Optional
7.12.11 GSTAmount String Total GST amount calculated based on the taxable amount and GST rate. Optional
7.13 SeatFare Decimal Total payable fare for this seat (usually same as OfferedFare). Mandatory
8 ResultUpperSeat{} Object Contain the details of Available Seats Mandatory
8.1 ColumnNo Integer Seat's column number in the layout grid. Mandatory
8.2 RowNo Integer Seat's row number in the layout grid. Mandatory
8.3 IsLadiesSeat Boolean Indicates if the seat is reserved for ladies. Value is "true" or "false". Mandatory
8.4 IsMalesSeat Boolean Indicates if the seat is reserved for males. Value is "true" or "false". Optional
8.5 IsUpper Boolean Shows if the seat is on the upper deck in a sleeper bus."true" or "false". Optional
8.6 SeatName String Label or number assigned to the seat (e.g., "1A"). Mandatory
8.7 SeatStatus Boolean "true" means seat is available; "false" means it is booked or not selectable. Mandatory
8.8 ReservedForSocialDistancing Boolean "true" if seat is blocked due to COVID/social distancing guidelines. Optional
8.9 DoubleBirth Boolean "true" if the seat is a double berth (usually in sleeper coaches). Optional
8.10 SeatType String Type of the seat (e.g., Seater, Sleeper, SemiSleeper, etc.). Mandatory
8.11 Width String Indicates how many blocks wide the seat occupies in the layout. Optional
8.12 Price{} Object Contains fare breakdown for the seat, including base fare, taxes, GST, etc. Mandatory
8.12.1 CurrencyCode String The currency in which the fare is quoted (e.g., "INR"). Mandatory
8.12.2 BaseFare String The basic fare of the seat before any taxes or discounts. Mandatory
8.12.3 Tax String Tax applicable on the base fare. Mandatory
8.12.4 Discount Decimal Any discount offered on the seat fare. Optional
8.12.5 PublishedFare String Total fare before discounts (BaseFare + Tax + Other Charges, if any). Mandatory
8.12.6 OfferedFare Decimal The final fare offered to the customer after applying discounts. Mandatory
8.12.7 AgentCommission Decimal Commission amount applicable for the agent on this fare. Optional
8.12.8 AgentMarkUp Decimal Additional markup amount added by the agent to the fare. Optional
8.12.9 GstTaxableAmount String The amount on which GST is calculated (usually equals BaseFare). Optional
8.12.10 GSTRate String GST percentage rate applied (e.g., 5%). Optional
8.12.11 GSTAmount String Total GST amount calculated based on the taxable amount and GST rate. Optional
8.12.12 SeatFare Decimal Total payable fare for this seat (usually same as OfferedFare) . Mandatory