Best fares, easy and straightforward integration

Designed with for developers

Verify Fares

Introduction

With the Sales Report endpoint you will be able to verify availability for your chosen flight and return flight without having to wait for a full search. Only your flights of choice will be queried for availability.

Fares are ALWAYS verified for availability upon Booking . However, for best user experience, we advise that you verify once more before taking your customers to your booking page. This will ensure that their flights are still available. If the last remaining seats get booked whilst they are filling their details, your booking API call will return an error and will NOT charge their credit/debit card.

Request Parameters

GET https://faresapi.com/api/v1/flights/fares/verify

In order to do that, you need to provide the following parameters. You may omit optional parameters

flightId Mandatory

A flight ID (see Search )

returnFlightId Optional

A flight ID (see Search )

residents[adults] Mandatory The number of adults flying, between 0 and 12. Any non-numeric value is ignored.
There should be at least one adult regardless of whether they are a resident or a non-resident.
residents[children] Optional The number of children flying, between 0 and 12. Any non-numeric value is ignored.
residents[infants] Optional The number of infants flying, between 0 and 12. Any non-numeric value is ignored.
nonResidents[adults] Mandatory The number of adults flying, between 0 and 12. Any non-numeric value is ignored.
There should be at least one adult regardless of whether they are a resident or a non-resident.
nonResidents[children] Optional The number of children flying, between 0 and 12. Any non-numeric value is ignored.
nonResidents[infants] Optional The number of infants flying, between 0 and 12. Any non-numeric value is ignored.

The same rules regarding passengers that apply to Search also apply here:

There should be at least one adult regardless of whether they are a resident or a non-resident.
Infants should be no more than Adults.

Response

The response consists of a JSON hash, where the keys are the Flight IDs, and the values are also hashes, where:
1. If a flight is not available, the value under the available key will be false and the flight key will be entirely missing.
2. If a flight is available, available will be true and the flight key will contain exactly the same data as returned by Search

For example, querying https://faresapi.com/api/v1/flights/fares/verify?accessToken=YourAccessTokenHere&flightId=352&residents%5Badults%5D=1   will return the following response (some parameters omitted for brevity)

{
    "352":{
        "available":true,
        "flight":{
            "from":{
                "id":1,
                "iata":"DAR",
                "city":"Dar Es Salaam",
                "country":"Tanzania"
            },
            "to":{
                "id":2,
                "iata":"ZNZ",
                "city":"Zanzibar",
                "country":"Tanzania"
            },
            "legs":[
                {
                    "from":{
                        "id":1,
                        "iata":"DAR",
                        "city":"Dar Es Salaam",
                        "country":"Tanzania"
                    },
                    "to":{
                        "id":2,
                        "iata":"ZNZ",
                        "city":"Zanzibar",
                        "country":"Tanzania"
                    },
                    "number":116,
                    "dates":{
                        "departure":"2018-02-25 23:30",
                        "arrival":"2018-02-25 23:45"
                    },
                    "duration":{
                        "human":"0h 15m",
                        "seconds":900
                    },
                    "airline":{
                        "id":1,
                        "name":"Test Airline",
                        "twoLetterCode":"TE"
                    }
                }
            ],
            "dates":{
                "departure":"2018-02-25 23:30",
                "arrival":"2018-02-25 23:45"
            },
            "duration":{
                "human":"0h 15m",
                "seconds":900
            },
            "airline":{
                "id":1,
                "name":"Test Airline",
                "twoLetterCode":"TE"
            },
            "site":{
                "id":1,
                "name":"Flight Co Tz",
                "url":"https://flight.co.tz/",
                "logo":"https://faresapi.com/bundles/apiv1/images/site/logo/flight.co.tz.png"
            },
            "id":1,
            "price":{
                "currency":"USD",
                "total":"84.00",
                "residents":{
                    "adult":84,
                    "child":null,
                    "infant":null
                },
                "nonResidents":{
                    "adult":94.5,
                    "child":null,
                    "infant":null
                }
            }
        }
    }
}

Introduction

Coming Soon