Skip to content

Search flights

GET/flights/search

Auth: X-API-Key headerhttps://warpdrive.staging.transferz.com/partners

Retrieves a list of flights for the provided parameters. At minimum the arrival and departure airport should be specified, along with an arrival or departure date.

Finds scheduled flights between two airports on a date, so the traveller can pick their flight and you can store the flight number with the booking. Give an arrival or a departure date (local to that airport). An empty list means no flights were found.

Guide: Request quotes

Query parameters

  • airlineIataCodestring

    The 2-letter IATA code of the airline, i.e. 'KL' for KLM

  • arrivalAirportIataCodestringrequired

    The 3-letter IATA code of the airport on which the flight is arriving

  • departureAirportIataCodestringrequired

    The 3-letter IATA code of the airport from which the flight is departing

  • arrivalDatestring

    The arrival date (local to the arrival airport)

  • departureDatestring

    The departure date (local to the departure airport)

Headers

  • X-Request-IDstring

    The optional (ideally unique) request identifier used for later analysis or diagnostics

Responses

OK

An array; each item has these attributes.

  • flightDesignatorsarray of objects

    The flight numbers of the flight, including codeshares.

  • scheduledDepartureTimeLocalstring · date-time

    Scheduled departure, local to the departure airport.

  • departureAirportIataCodestring
  • scheduledArrivalTimeLocalstring · date-time

    Scheduled arrival, local to the arrival airport.

  • arrivalAirportIataCodestring
  • departureAirportCountryCodestring
  • arrivalAirportCountryCodestring

Errors this endpoint can return

  • 400, failedUNKNOWN

    When: Neither arrivalDate nor departureDate is given.

    What to do: For 400, read message and correct the request. For 500, retry once; if it persists, contact Transferz support with the X-Request-ID you sent.

Walk-through step

Guide