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-05-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-05-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-05-12T08:00:00",
            "departure_timezone": "America/Los_Angeles",
            "departure_time_utc": "2026-05-12T15:00:00Z",
            "arrival_airport": "JFK",
            "arrival_time_local": "2026-05-12T16:30:00",
            "arrival_timezone": "America/New_York",
            "arrival_time_utc": "2026-05-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. 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.

Each entry in booking_options 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