This API Endpoint makes a POST request to the Travu API in other to get a response of AVAILABLE FLIGHT TRIPS from all our aggregated flight operators based on the requested DEPARTURE , DESTINATION, DATE etc.
ENDPOINT URL
REQUEST TYPE : POST
API BASE URL : https://access.mytrip.ng/api/v1/search_flight (Coming soon)
Remember to Pass your Authorization Token for this request to go through, read about Authorization here .
To build the payload you'll need the flight itinerary - which should include the origin(s), destination(s) and departure date(s) - and information about the passengers. Here's how we search for flights:
Our Supported Departure and Destination Strings to be used can be derived from the Get List of Airports Endpoint;
BODY PAYLOAD
The Body Payload is as below;
Payload Example for a one way ticket.
Copy {
"type": "Oneway",
"class": "Y",
"adult": 1,
"children": 0,
"infant": 0,
"currency": "NGN",
"itineraries": [
{
"Departure": "LOS",
"Destination": "ABV",
"DepartureDate": "04/26/2023"
}
]
} Payload Example for a Return ticket.
Copy {
"type": "Return",
"class": "Y",
"adult": 1,
"children": 0,
"infant": 0,
"currency": "NGN",
"itineraries": [
{
"Departure": "LOS",
"Destination": "ABV",
"DepartureDate": "04/26/2023"
},
{
"Departure": "ABV",
"Destination": "LOS",
"DepartureDate": "04/28/2023"
}
]
} Payload Example for a Multi destination ticket, this supports between 2 to 6 destinations.
Copy {
"type": "Multidestination",
"class": "Y",
"adult": 1,
"children": 0,
"infant": 0,
"currency": "NGN",
"itineraries": [
{
"Departure": "LOS",
"Destination": "ABV",
"DepartureDate": "04/26/2023"
},
{
"Departure": "ABV",
"Destination": "MAN",
"DepartureDate": "04/28/2023"
},
{
"Departure": "MAN",
"Destination": "LOS",
"DepartureDate": "04/30/2023"
}
]
} RESPONSE
The Response for this request should bring the TRIP DETAILS in the below format if;
The "type" parameter is "Oneway" which should come with one objects in the "Itineraries" of Array.
Copy {
"GUO": {
"error": false,
"message": "successful",
"info": "Data Available",
"data": [
{
"provider": {
"name": "GUO Transport",
"short_name": "GUO"
},
"boarding_at": "28",
"trip_id": 96861,
"trip_no": 450096861,
"trip_date": "2021-07-10",
"depature_time": "2018-04-24 08:04:00",
"origin_id": "",
"destination_id": 63,
"narration": "UMUAHIA - LAGOS - AJAH",
"fare": 6500,
"total_seats": 15,
"available_seats": [
1,
2,
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
],
"blocked_seats": [
2,
3
],
"special_seats": [],
"special_seats_fare": "",
"order_id": "eef50d24",
"departure_terminal": "UMUAHIA",
"destination_terminal": "LAGOS - AJAH",
"vehicle": "Hiace - 1st Bus (15)"
},
{
"provider": {
"name": "GUO Transport",
"short_name": "GUO"
},
"trip_id": 96861,
"trip_no": 450096861,
"trip_date": "2021-07-10",
"depature_time": "2018-04-24 08:04:00",
"origin_id": "",
"destination_id": 63,
"narration": "UMUAHIA - LAGOS - AJAH",
"fare": 7000,
"total_seats": 15,
"available_seats": [
1,
2,
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
],
"blocked_seats": [
2,
3
],
"special_seats": [],
"special_seats_fare": "",
"order_id": "0e2c886c",
"departure_terminal": "UMUAHIA",
"destination_terminal": "LAGOS - AJAH",
"vehicle": "Hiace - 1st Bus (15)"
}
]
},
"ABC": {
"error": true,
"message": "failed",
"info": "Terminals does not exist between states",
"data": []
}
} The "type" parameter is "Return" which should come with one objects in the "Itineraries" of Array.
Copy {
"error": false,
"message": "successful",
"info": "Data Available",
"data": [
{\o
"provider": {
"name": "ABC Transport",
"short_name": "ABC"
},
"trip_id": 26528,
"trip_no": 4,
"trip_date": "2022-01-09",
"departure_time": "09/01/2022 06:00",
"origin_id": 13,
"destination_id": 25,
"narration": "GWAGWALADA TO LAGOS JIBOWU",
"fare": 14350,
"total_seats": 14,
"available_seats": [
0,
10,
11,
12,
13,
14
],
"blocked_seats": [],
"special_seats": [],
"special_seats_fare": "",
"order_id": 20,
"departure_terminal": "GWAGWALADA",
"destination_terminal": "LAGOS JIBOWU",
"vehicle": "2+2, Sprinter Service, AC, Non-Video",
"boarding_at": "10",
"departure_address": "Ground Floor wing B Kaita Plaza, by Mtnoffice cls toJeparo Hotel",
"destination_address": "22 IKORODU ROAD JIBOWU"
},
{
"provider": {
"name": "GUO Transport",
"short_name": "GUO"
},
"trip_id": 482850,
"trip_no": 30482850,
"trip_date": "2022-01-09",
"departure_time": "09/01/2022 20:01",
"origin_id": "",
"destination_id": 64,
"narration": "UTAKO - LAGOS - COKER",
"fare": 10500,
"total_seats": 59,
"available_seats": [
10,
11,
12,
13,
14
],
"blocked_seats": [],
"special_seats": [],
"special_seats_fare": "",
"order_id": "de5426cf",
"departure_terminal": "UTAKO",
"destination_terminal": "LAGOS - COKER",
"vehicle": "Luxury - 1st Bus (59)",
"boarding_at": "",
"departure_address": "Gouba Plaza, Plot171, Ekukinam Street, Utako District, Abuja.",
"destination_address": "LAGOS - COKER Terminal"
}
]
} The "type" parameter is "Multidestination" which should come with one objects in the "Itineraries" of Array, comes with a minimum of two and a maximum of six objects in the "Itineraries" of Array.
Reference to Authentication for possible authentication errors that might occur during this request.
