Quickstart

Go from zero to live flight data in three steps. This guide walks through a complete search-to-booking flow.

Step 1: Sign up and get an API key

Create a free account to get your API key. You can view and rotate your key anytime from the dashboard. Include it in every request via the X-Api-Key header.

Step 2: Search for flights

Pick an origin, destination, and date. The API returns a list of itineraries with prices, leg details, and flight segments.

Open Playground

curl -X POST "https://ignav.com/api/fares/one-way" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"origin":"SFO","destination":"JFK","departure_date":"2026-07-12"}'

The response contains an itineraries array. Each itinerary has a unique ignav_id you'll use in the next step.

Abbreviated response

{
  "origin": "SFO",
  "destination": "JFK",
  "departure_date": "2026-07-12",
  "itineraries": [
    {
      "price": {
        "amount": 299,
        "currency": "USD"
      },
      "outbound": {
        "carrier": "American Airlines",
        "duration_minutes": 330,
        "segments": [
          {
            "marketing_carrier_code": "AA",
            "flight_number": "100",
            "operating_carrier_name": "American Airlines",
            "departure_airport": "SFO",
            "departure_time_local": "2026-07-12T08:00:00",
            "departure_timezone": "America/Los_Angeles",
            "departure_time_utc": "2026-07-12T15:00:00Z",
            "arrival_airport": "JFK",
            "arrival_time_local": "2026-07-12T16:30:00",
            "arrival_timezone": "America/New_York",
            "arrival_time_utc": "2026-07-12T20:30:00Z",
            "duration_minutes": 330,
            "aircraft": "Boeing 777"
          }
        ]
      },
      "cabin_class": "economy",
      "ignav_id": "5e4fcd2f1dc340649eb19f6ee2afb57a"
    }
  ]
}

Step 3: Get booking links

Pass the ignav_id from any itinerary to the booking links endpoint. When usable links are available, you'll get back direct URLs to airline and OTA booking pages.

Open Playground

curl -X POST "https://ignav.com/api/fares/booking-links" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ignav_id":"5e4fcd2f1dc340649eb19f6ee2afb57a"}'

In the playground, search for fares first, then select an itinerary to fetch its booking links — the same flow you'd use with ignav_id in your code.

booking_options can be empty. When present, each entry tells you which legs that purchase covers, and its links contain the provider URLs and optional fare metadata.

Related docs

Ready to get started?

Create a free account to get your API key, or try the playground — no signup required.

Get API key Try the Playground