Ignav

# Flight Search via Ignav API

Fast REST API flight search at `https://ignav.com`. Returns structured JSON with prices, itineraries, and booking links. 1,000 free requests, no rate limit.

## Setup

Get a free API key at https://ignav.com/signup (1,000 requests, no credit card).

Set `IGNAV_API_KEY` in your environment or `.env` file.

## Workflow

1. Parse the user's request (origin, destination, dates, trip type, passengers, cabin)
2. Look up airport codes if user gave city names
3. Search flights (one-way or round-trip)
4. Present results in markdown table
5. Get booking links if user wants to book

## Endpoints

### Search Airports

```bash
curl -s "https://ignav.com/api/airports?q=Barcelona&limit=5" \
  -H "X-Api-Key: $IGNAV_API_KEY"
```

### One-Way Flights

```bash
curl -s -X POST "https://ignav.com/api/fares/one-way" \
  -H "X-Api-Key: $IGNAV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "origin": "SFO",
    "destination": "JFK",
    "departure_date": "2026-05-15",
    "adults": 1,
    "cabin_class": "economy"
  }'
```

### Round-Trip Flights

```bash
curl -s -X POST "https://ignav.com/api/fares/round-trip" \
  -H "X-Api-Key: $IGNAV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "origin": "SFO",
    "destination": "JFK",
    "departure_date": "2026-05-15",
    "return_date": "2026-05-20",
    "adults": 1,
    "cabin_class": "economy"
  }'
```

### Booking Links

```bash
curl -s -X POST "https://ignav.com/api/fares/booking-links" \
  -H "X-Api-Key: $IGNAV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ignav_id": "the_itinerary_id", "adults": 1}'
```

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `adults` | int | Number of adults (default: 1) |
| `children` | int | Number of children (default: 0) |
| `cabin_class` | string | `economy`, `premium_economy`, `business`, `first` |
| `max_stops` | int | 0 (direct only), 1, or 2 |
| `max_price` | int | Maximum price filter |
| `departure_time_range` | object | `{"earliest_hour": 8, "latest_hour": 20}` |
| `airlines_include` | array | Only these airline codes |
| `airlines_exclude` | array | Exclude these airline codes |
| `market` | string | Country code for pricing (default: "US"). Different markets return different prices. |

## Response Structure

Each itinerary contains:
- `price`: `{"amount": 299, "currency": "USD"}`
- `outbound`: carrier, duration_minutes, segments array
- `inbound`: same (null for one-way)
- `cabin_class`: the cabin class
- `bags`: `{"carry_on": 1, "checked": 0}`
- `ignav_id`: unique ID for booking links

Each segment: `marketing_carrier_code`, `flight_number`, `departure_airport`, `departure_time_local`, `arrival_airport`, `arrival_time_local`, `duration_minutes`, `aircraft`.

## Output Format

**Always use markdown tables.**

| # | Airline | Stops | Duration | Depart | Arrive | Price | Bags |
|---|---------|-------|----------|--------|--------|-------|------|
| 1 | Vueling | Nonstop | 2h 15m | 8:30 AM | 10:45 AM | EUR 125 | 1 carry-on |
| 2 | Ryanair | Nonstop | 2h 20m | 6:15 AM | 8:35 AM | EUR 89 | 1 carry-on |

After the table, highlight cheapest, fastest, and best value. Call out tradeoffs. Offer booking links.

## Notes

- Dates are required for all searches
- Default to round-trip and economy if not specified
- Use airport search endpoint for city name lookups
- **Market affects prices.** Same route can cost significantly less from a different market. Try departure country first, then destination country.
- **Does NOT include Southwest.** Use google-flights skill for SW.