Search

This method provides availability information with the cheapest fare option available. The request includes single query. When properly submitted, the Search Response returns the available option.

Once the requested query is parsed and validated, the booking engine starts searching for the best option. If the search is successful it will return Result object.

Bus Search Test API Notice:

Please note that the test API may occasionally fail to return results. If this happens, please try again after a short while. For more consistent and reliable results during testing, we recommend using the Bangalore (19402) to Hyderabad (8875) route, as it typically returns data successfully.

Service URL (REST) to be used:
https://bus.srdvtest.com/v9/rest/Search
Search Request
Level Element Format Comments Mandatory
1 ClientId String Client ID provided to the agency at registration Mandatory
2 UserName String User name provided to the agency at registration Mandatory
3 Password String Password provided to the agency at registration Mandatory
4 FromCityCode Integer City ID of Source/Origin City Ex: 8875 (City ID for Bhubaneshwar) Mandatory
5 ToCityCode Integer City ID of Destination City Ex: 19402 (City ID for Baripada) Mandatory
6 DepartDate Date Time Preferred date time Format: YYYY-MM-DD [2025-07-19] Mandatory
Search Response
Level Element Format Comments Mandatory
1 Error{} Object Error Mandatory
1.1 ErrorCode Integer Code corresponding to the Error Mandatory
1.2 ErrorMessage String Contains error description corresponding to ErrorCode. Error Message would be blank in case ErrorCode = 0. Mandatory
2 TraceId Integer Unique identifier for identifying every unique search Required for audit purpose. Mandatory
3 Result[] Array Contain the details of Bus Mandatory
3.1 SrdvIndex Integer Unique API Index Mandatory
3.2 ResultIndex String Define the result number Mandatory
3.3 DepartureTime Date Time Preferred date time Format: yyyy-MM-dd TH HH:mm:ss (Define the bus departure date time.) Mandatory
3.4 ArrivalTime Date Time Preferred date time Format: yyyy-MM-dd TH HH:mm:ss (Approx. arrival time at the destination.) Mandatory
3.5 Duration Time Duration of the journey in minutes Mandatory
3.6 IsArrivingNextDay Boolean Define whether the bus is arriving the next day or not.(if arrivingNextDay is true the bus arrives the next day.) Mandatory
3.7 AvailableSeats String No. of available seats (E.g., 24). Mandatory
3.8 MaxSeatsPerTicket String Define maximum No. of seats can be booked in a single ticket. Mandatory
3.9 RouteId String Unique Route ID Mandatory
3.10 BusRoute String Define the bus route.(e.g. city A-city B) Mandatory
3.11 BusType String Define the Bus Type.(e.g.Leyland A/C Sleeper/Semi Sleeper (2+2)etc.) Mandatory
3.12 OperatorId String Unique OperatorId Mandatory
3.13 TravelsName String Name of the travel agency Mandatory
3.14 Seater Boolean Possible values are true or false. Mandatory
3.15 Sleeper Boolean Possible values are true or false. Mandatory
3.16 MTicketEnabled Boolean Mobile Ticket is enabled or not Mandatory
3.17 IdProofRequired Boolean Define whether ID proof is required or not Mandatory
3.18 IsDropPointMandatory Boolean Define whether dropping point is mandatory or not. Mandatory
3.19 IsAC Boolean Define whether the bus is AC or not. Mandatory
3.20 LiveTracking Boolean Define whether live tracking is enabled or not. Mandatory
3.21 OTGEnabled Boolean Define whether OTG is enabled or not. Mandatory
3.22 VaccinatedBus Boolean Define whether the bus is vaccinated or not. Mandatory
3.23 VaccinatedStaff Boolean Define whether the staff is vaccinated or not. Mandatory
3.24 BoardingPoints[] Array Array of boarding point detail like boarding point name and time. Mandatory
3.24.1 Id String Index of the boarding point (e.g. 43289) . Mandatory
3.24.2 Name String Name of the boarding point at Source (e.g. Baramunda) . Mandatory
3.24.3 Address String Address of the boarding point (e.g. Baramunda Bus Terminus). Mandatory
3.24.4 Location String Location of the boarding point (e.g.Baramunda Bus Terminus) . Mandatory
3.24.5 Landmark String Landmark of the boarding point (e.g. near Baramunda Bus Terminus). Mandatory
3.24.6 ContactNumber String Contact No. at Boarding Point. Mandatory
3.24.7 Time Time Time of arrival at Boarding Point in HH:MM format. Mandatory
3.24.8 IsPrime Boolean Define whether the Bus is prime. Mandatory
3.25 DroppingPoints Array[] Array of dropping point detail like dropping point name and time. Mandatory
3.25.1 Id String Index of the dropping point (e.g. 43289). Mandatory
3.25.2 Name String Name of the dropping point at Source (e.g. Baramunda ) . Mandatory
3.25.3 Address String Address of the dropping point (e.g. Baramunda Bus Terminus). Mandatory
3.25.4 Location String Location of the dropping point (e.g. Baramunda Bus Terminus). Mandatory
3.25.5 Landmark String Landmark of the dropping point (e.g. near Baramunda Bus Terminus). Mandatory
3.25.6 ContactNumber Integer Contact No. at dropping Point. Mandatory
3.25.7 Time Time Time of arrival at dropping Point in HH:mm format. Mandatory
3.25.8 IsPrime Boolean Define whether the Bus is is prime. Mandatory
3.26 DisplayFare Decimal Display fare. Mandatory
3.27 Price Array[] Contains Fare Breakup Details. Mandatory
3.27.1 CurrencyCode String ISO currency code (e.g., INR for Indian Rupees) Mandatory
3.27.2 BaseFare String The core fare without taxes and charges Mandatory
3.27.3 Tax String Tax amount applied on the BaseFare. In this case, it's GST. Mandatory
3.27.4 OtherCharges String Any additional fees (e.g., service charge, booking fee) Optional
3.27.5 Discount String Discount amount (often applied at checkout; 0 if none) Optional
3.27.6 PublishedFare String Final fare before any discounts or commissions; usually BaseFare + Tax + OtherCharges Mandatory
3.27.7 OfferedFare Decimal What the customer is expected to pay—a discounted fare or one extended through a special offer Mandatory
3.27.8 AgentCommission Decimal Commission earned by the agent booking the ticket Optional
3.27.9 MarkUp String Additional margin added on top of the fare by the reseller or agent Optional
3.27.10 GstTaxableAmount String The amount on which GST is calculated (usually the Base Fare) Optional
3.27.11 GstRate String The GST % rate applied Optional
3.27.12 GstAmount String Calculated tax based on GstRate × GstTaxableAmount , often same as value in Tax Optional
3.28 PartialCancellationAllowed Boolean Indicates if partial cancellation is allowed for the bus Mandatory
3.29 CancellationPolicies Array[] Contains the cancellation rules defined by the bus operator. Mandatory
3.29.1 CancellationCharge String The cancellation charge value depends on the CancellationChargeType; for example, if the charge is 100 and the type is Percentage, then 100% of the fare will be charged. Mandatory
3.29.2 CancellationChargeType String Indicates the type of cancellation charge: - Percentage: The charge is a % of the fare - Fixed: The charge is a fixed amount Mandatory
3.29.3 PolicyString String Human-readable explanation of the cancellation rule. Useful for showing to the end user directly on UI. Mandatory
3.29.4 TimeBeforeDept Time The time window (in hours) before scheduled departure for which this cancellation rule applies. Example: 12 means the rule applies from 0 to 12 hours before departure. Mandatory
3.29.5 FromDate Date The date from which the cancellation policy is applicable (usually the departure date). Optional