BUS TICKET BOOKING API


GET: https://www.goalltrip.com/api/bus/citylist?gatkey=gatkey


    

{
      "stationName": "Agra Package",
      "stationId": 6868
    },
    {
      "stationName": "Agra Sight Seen",
      "stationId": -1
    },
    {
      "stationName": "Agra Sightseen(One Day Tour)",
      "stationId": -1
    },
    {
      "stationName": "Agumbe",
      "stationId": 12283
    },
    {
      "stationName": "Ahmedabad",
      "stationId": 2434
    },
    }

    

GET: https://www.goalltrip.com/api/bus/search_bus?gatkey=gatkey&sourceCity=Hyderabad&destinationCity=Bangalore&date=2016-11-28

S.No Attribute Descriptions Required
1 gatkey gatkey (provided by Goalltrip) true
2 SourceCity SourceCity Name true
3 DestinationCity DestinationCity Nmae true
4 Date yyyy-MM-dd true

    
  
  "apiAvailableBuses": [
    {
      "droppingPoints": null,
      "availableSeats": 41,
      "partialCancellationAllowed": false,
      "arrivalTime": "10:30 PM",
      "cancellationPolicy": 
      "boardingPoints": [       
        {
          "time": "01:30PM",
          "location": "Miyapur (Near More Supermarket),Kallada Travels, Hema Durga Plaza,9347455500",
          "id": "3878"
        },
        {
          "time": "01:40PM",
          "location": "Kondapur,infront of RT office,9347455500, 040-30425500",
          "id": "3880"
        },
        {
          "time": "01:45PM",
          "location": "Gachibowli,09392125500",
          "id": "3881"
        },
        {
          "time": "02:00PM",
          "location": "Lakdi-ka-pool ( van pickup ),Neeta travels ,9391555000,040-30585500",
          "id": "3883"
        },
      
        {
          "time": "12:45PM",
          "location": "Ameerpet ( van pickup ),9392055500,040-30585500",
          "id": "3888"
        },
        {
          "time": "03:15PM",
          "location": "Kottoor Busbay,9392555500,040-30585500",
          "id": "4311"
        },
       
      ],
      "operatorName": "KALLADA TOURS & TRAVELS",
      "departureTime": "1:15 PM",
      "mTicketAllowed": false,
      "idProofRequired": false,
      "serviceId": "20145",
      "fare": "1000",
      "busType": "Scania Metrolink A/C",
      "routeScheduleId": "20145",
      "commPCT": 5.2,
      "operatorId": 3,
      "inventoryType": 0
    },
        
    

GET: https://www.goalltrip.com/api/bus/seat_layout?gatkey=gatkey&sourceCity=Hyderabad&destinationCity=Bangalore&doj=2016-08-24&inventoryType=114&routeScheduleId=11553

S.No Attribute Descriptions Required
1 gatkey gatkey (provided by Goalltrip) true
2 SourceCity SourceCity Name true
3 DestinationCity DestinationCity Nmae true
4 Date yyyy-MM-dd true
4 inventoryType InventoryType value true
4 routeScheduleId routeScheduleId value true

    
                                           
                                           
 {
  "seats": [
    {
      "ladiesSeat": false,
      "fare": 1000,
      "zIndex": 0,
      "serviceTaxAmount": 60,
      "commission": null,
      "operatorServiceChargeAbsolute": 0,
      "operatorServiceChargePercent": 0,
      "totalFareWithTaxes": 1060,
      "bookedBy": null,
      "ac": false,
      "sleeper": false,
      "serviceTaxPer": 4.94,
      "width": 1,
      "available": true,
      "row": 0,
      "column": 0,
      "length": 1,
      "id": "A1"
    },
    
        
    

Seat Layout Example


    
    
       ZIndex=0, Length=1 and Width=1
    
        



zIndex=0/1, Length=1 and Width=2 with lower and upper berths



zIndex=0, Length=2 and Width=1 with all lower berths



zIndex=0, Length=2 and Width=1 with all lower berths


GET: https://www.goalltrip.com/api/bus/block_ticket?gatkey=gatkey

S.No Attribute Descriptions Required
1 gatkey gatkey (provided by goalltrip) true
2 APIBlockTicketRequest Elements of APIBlockTicketRequest array. It contains the following member variables. sourceCity, destinationCity, customerEmail,customerName,customerLastName,DOJ, boardingPoint, routeScheduleId, customerPhone, emergencyPhNumber, CustomerAddress, inventoryType, blockSeatPaxDetails true
3 sourceCity Name of the source city true
4 destinationCity Name of the destination city true
5 inventoryType InventoryType value true
5 routeScheduleId routeScheduleId value true
5 customerName Name of the person whobook the ticket true
5 customerLastName Last Name of the person who book the ticket true
5 customerEmail Email id of the person who book the ticket true
5 DOJ Date of Journey in the yyyy//mm/dd format true
5 boardingPoint It consists of id, location, time true
5 id Boarding point id true
5 location Boarding point location true
5 Time Boarding point dispatcher time true
5 customerPhone Mobile number of the person who book the ticket true
5 emergencyPhNumber Emergency mobile number true
5 CustomerAddress Address of the person who book the ticket true
5 blockSeatPaxDetails List of BlockSeatPaxDetails member variables. It Consists of age, name, seatNbr, sex, fare, totalFareWithTaxes, ladiesSeat, lastName, mobile, title, email, idType, idNumber, nameOnId, primary, ac, sleeper. true
5 Age Passenger Age true
5 name Passenger Name true
5 seatNbr Passenger Seat Number true
5 Sex Sex(M/F) true
5 Fare Seat Fare true
5 totalFareWithTaxes Seat Fare with service tax amount true
5 ladiesSeat LadiesSeat(true/false) true
5 lastName Last name of the Passenger true
5 mobile Mobile number of the person who travel true
5 Title Title true
5 email Email id of the person who travel true
5 idType Id Card Type(pan,passport,.....) true
5 idNumber Id Card Number of given Card true
5 nameOnId Name on the Id Card true
5 primary Is primary passenger (true/false) true
5 Ac Is AC bus(true/false) true
5 sleeper Is Sleeper(true/false) true

    
                                           
           

Request in Json Format

{ "sourceCity": "Hyderabad", "destinationCity": "Bangalore", "doj": "2014-04-11", "routeScheduleId": "6310", "boardingPoint": { "id": "6", "location": "Ameerpet,|Jeans Corner", "time": "09:00PM" }, "customerName": "Goalltrip", "customerLastName": "testing", "customerEmail": "care@goalltrip.com", "customerPhone": "9051689072", "emergencyPhNumber": "9051689072", "customerAddress": "kphp", "blockSeatPaxDetails": [ { "age": "26", "name": "test123", "seatNbr": "R9", "sex": "M", "fare": 425, "totalFareWithTaxes": 456, "ladiesSeat": false, "lastName": "test456", "mobile": "7890080744", "title": "Mr", "email": "care@goalltrip.com", "idType": "PAN", "idNumber": "AWk123232", "nameOnId": "test", "primary": true, "ac": false, "sleeper": false } ], "inventoryType": 0 }

Response in Json Format

{ "blockTicketKey":"ETS0S2833565", "inventoryType":0, "apiStatus":{ "message":"SUCCESS", "success":true } }

GET: https://www.goalltrip.com/api/bus/seat_booking?gatkey=gatkey&blockTicketKey=blockTicketKey

S.No Attribute Descriptions Required
1 gatkey gatkey (provided by Goalltrip) true
2 blockTicketKey blockTicketKey true

    
                                           
                                           
  
   {
  "opPNR": "ABRS978477",
  "cancellationPolicy": "[{\"cutoffTime\":\"1\",\"refundInPercentage\":\"10\"},{\"cutoffTime\":\"2\",
  \"refundInPercentage\":\"50\"},{\"cutoffTime\":\"4\",\"refundInPercentage\":\"90\"}]",
  "etstnumber": "ETS611B0PT12668", 
  "commPCT": 9,
  "totalFare": 790,
  "inventoryType": 0,
  "apiStatus": {
    "success": true,
    "message": "SUCCESS"
  }
}
    
    
        
    

GET: https://www.goalltrip.com/api/bus/seat_booking?gatkey=gatkey&etstnumber=etstnumber

S.No Attribute Descriptions Required
1 gatkey gatkey (provided by Goalltrip) true
2 ETSTNumber ETS Ticket number generated after successful booking. true

    
                                           
                                           
  {
  "opPNR": "ABRS978477",
  "cancellationPolicy": "[{\"cutoffTime\":\"1\",\"refundInPercentage\":\"10\"},{\"cutoffTime\":\"2\",\"refundInPercentage\":\"50\"},{\"cutoffTime\":\"4\",\"refundInPercentage\":\"90\"}]",
  "departureTime": "10:00PM",
  "service_type": "Volvo B9R Multi-Axle Semi Sleeper",
  "serviceId": "SVR 2016(UP TO MARTHAHALLI)",
  "serviceTaxAmount": 0,
 "etstnumber": "ETS611B0PT12668",
  "sourceCity": "Hyderabad",
  "destinationCity": "Bangalore",
  "boardingPoint": "K.P.H.B - 10:00 PM",
  "routeScheduleId": "3312",
  "droppingPoint": null,
  "serviceProvider": "Apple I Bus",
  "totalFareWithTaxes": 790,
  "commPCT": 9,
  "refundAmount": 0,
  "journeyDate": "Mon,27-Jun-2016",
  "travelerDetails": [
    {
      "gender": "M",
      "fare": 790,
      "lastName": "sarkar",
      "age": 26,
      "seatNo": "43",
      "name": "dip"
    }
  ],
  "cancelDate": null,
  "bookingDate": 1465651385000,
  "ticketStatus": "CONFIRMED",
  "inventoryType": "0",
  "apiStatus": {
    "success": true,
    "message": "SUCCESS"
  },
  "serviceProviderContact": "Beside J.C.Brothers Ph. 9397981444"
}
    
        
    

GET: https://www.goalltrip.com/api/bus/cancel_ticket_confirm?gatkey=gatkey

S.No Attribute Descriptions Required
1 gatkey gatkey (provided by Goalltrip) true
2 etstnumber We need to provide etstnumber true
2 seatNbrsToCancel List seat numbers to cancel true

    
                                           
                                           
  
 

Request

{ "etsTicketNo":"ETS611B0PT12668", "seatNbrsToCancel":[ "43", "45" ] }

Response

{ "cancelChargesPercentage": "10 %", "totalTicketFare": "790.00", "totalRefundAmount": "711", "cancellable": true, "partiallyCancellable": false, "cancellationCharges": 79, "apiStatus": { "success": true, "message": "SUCCESS" } }