---
canonical_url: "https://docs.composio.dev/toolkits/ignav_flights"
markdown_url: "https://docs.composio.dev/toolkits/ignav_flights.md"
product: "platform"
version: null
last_updated: null
---

# Ignav Flights

Search airports and flight fares, compare one-way, round-trip, and flexible itineraries, and retrieve airline or travel-agency booking links with Ignav.

- **Category:** lifestyle & entertainment
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 5
- **Triggers:** 0
- **Slug:** `IGNAV_FLIGHTS`
- **Version:** 20261015_00
- **Instant:** Supported on the latest version. Support varies by tool.

## Tools

### Get Booking Links

**Slug:** `IGNAV_FLIGHTS_GET_BOOKING_LINKS`

Get current direct airline or OTA booking links for a recent Ignav fare result or a manually specified one-way/round-trip flight. ID lookup uses your own connected account; managed calls support manual_one_way or manual_round_trip only. Each successful call consumes one Ignav usage request and may be charged after the one-time free allowance.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.002 per successful request

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `lookup` | string | Yes | Required lookup mode and its fields. Managed calls must choose manual_one_way or manual_round_trip. With your own connected account, prefer ignav_id from a recent search for an exact itinerary match. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Airports

**Slug:** `IGNAV_FLIGHTS_SEARCH_AIRPORTS`

Find supported airport-level IATA codes by code, airport name, city, country, or metro-style query. Use before fare search when an airport code is uncertain. Each successful call consumes one Ignav usage request and may be charged after the one-time free allowance.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.002 per successful request

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum matching airports to return (1-20). This limits one complete response; it is not pagination. |
| `query` | string | Yes | Airport code, airport name, city, country, or common metro-style search text; at least 2 characters. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Flexible Fares

**Slug:** `IGNAV_FLIGHTS_SEARCH_FLEXIBLE_FARES`

Search one or two ordered flight legs for multi-city, open-jaw, or other flexible trips. Returns ranked complete journeys rather than every leg combination. Each successful call consumes one Ignav usage request and may be charged after the one-time free allowance.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.002 per successful request

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `legs` | array | Yes | One or two ordered trip legs in chronological date order. Use airport or supported metro IATA codes. Itinerary segments identify concrete airports. |
| `adults` | integer | No | Number of adult passengers; total passengers across all categories cannot exceed 9. |
| `market` | string ("AE" | "AR" | "AT" | "AU" | "BD" | "BE" | "BG" | "BH" | "BO" | "BR" | "CA" | "CH" | "CL" | "CN" | "CO" | "CR" | "CY" | "CZ" | "DE" | "DK" | "DO" | "EC" | "EE" | "EG" | "ES" | "FI" | "FR" | "GB" | "GH" | "GR" | "GT" | "HK" | "HN" | "HR" | "HU" | "ID" | "IE" | "IL" | "IN" | "IS" | "IT" | "JO" | "JP" | "KE" | "KH" | "KR" | "KW" | "LK" | "LT" | "LU" | "LV" | "MA" | "MT" | "MX" | "MY" | "NG" | "NL" | "NO" | "NP" | "NZ" | "OM" | "PA" | "PE" | "PH" | "PK" | "PL" | "PT" | "PY" | "QA" | "RO" | "RU" | "SA" | "SE" | "SG" | "SI" | "SK" | "SV" | "TH" | "TN" | "TR" | "TW" | "TZ" | "UA" | "UG" | "US" | "UY" | "VN" | "ZA") | No | Provider-supported ISO 3166-1 alpha-2 market controlling availability and currency. |
| `children` | integer | No | Number of child passengers. |
| `max_price` | integer | No | Strict maximum total price in the selected market's currency. |
| `cabin_class` | string ("economy" | "premium_economy" | "business" | "first") | No | Requested cabin class. |
| `infants_on_lap` | integer | No | Number of lap infants; cannot exceed the adult count. |
| `infants_in_seat` | integer | No | Number of infants occupying seats. |
| `airlines_exclude` | array | No | Non-empty list of 2-character uppercase airline codes to exclude; cannot overlap airlines_include. |
| `airlines_include` | array | No | Non-empty list of 2-character uppercase airline codes to include exclusively; cannot overlap airlines_exclude. |
| `min_checked_bags` | integer | No | Minimum number of included checked bags. |
| `min_carry_on_bags` | integer | No | Minimum number of included carry-on bags. |
| `allow_self_transfer` | boolean | No | Allow identifiable self-transfers. False is a best-effort filter, not a guarantee of a protected through-ticket. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search One-Way Fares

**Slug:** `IGNAV_FLIGHTS_SEARCH_ONE_WAY_FARES`

Search complete one-way flight itineraries between two airport or supported metro IATA codes on a future date. Returns ranked fares and ignav_id values for booking-link lookup. Each successful call consumes one Ignav usage request and may be charged after the one-time free allowance.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.002 per successful request

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `adults` | integer | No | Number of adult passengers; total passengers across all categories cannot exceed 9. |
| `market` | string ("AE" | "AR" | "AT" | "AU" | "BD" | "BE" | "BG" | "BH" | "BO" | "BR" | "CA" | "CH" | "CL" | "CN" | "CO" | "CR" | "CY" | "CZ" | "DE" | "DK" | "DO" | "EC" | "EE" | "EG" | "ES" | "FI" | "FR" | "GB" | "GH" | "GR" | "GT" | "HK" | "HN" | "HR" | "HU" | "ID" | "IE" | "IL" | "IN" | "IS" | "IT" | "JO" | "JP" | "KE" | "KH" | "KR" | "KW" | "LK" | "LT" | "LU" | "LV" | "MA" | "MT" | "MX" | "MY" | "NG" | "NL" | "NO" | "NP" | "NZ" | "OM" | "PA" | "PE" | "PH" | "PK" | "PL" | "PT" | "PY" | "QA" | "RO" | "RU" | "SA" | "SE" | "SG" | "SI" | "SK" | "SV" | "TH" | "TN" | "TR" | "TW" | "TZ" | "UA" | "UG" | "US" | "UY" | "VN" | "ZA") | No | Supported country market controlling fare availability and currency. |
| `origin` | string | Yes | Departure airport or supported metro IATA code, such as SFO or LON. |
| `children` | integer | No | Number of child passengers. |
| `max_price` | integer | No | Strict maximum total price in the selected market's currency. |
| `max_stops` | integer | No | Maximum stops; omit to allow any number. |
| `cabin_class` | string ("economy" | "premium_economy" | "business" | "first") | No | Requested cabin class. |
| `destination` | string | Yes | Arrival airport or supported metro IATA code, such as JFK or PAR. |
| `departure_date` | string | Yes | Departure date in YYYY-MM-DD format; cannot be in the past. |
| `infants_on_lap` | integer | No | Number of lap infants; cannot exceed the adult count. |
| `infants_in_seat` | integer | No | Number of infants occupying seats. |
| `airlines_exclude` | array | No | Exclude these 2-character uppercase airline codes; cannot overlap airlines_include. |
| `airlines_include` | array | No | Only include these 2-character uppercase airline codes; cannot overlap airlines_exclude. |
| `min_checked_bags` | integer | No | Minimum included checked bags. |
| `min_carry_on_bags` | integer | No | Minimum included carry-on bags. |
| `allow_self_transfer` | boolean | No | Allow identifiable self-transfers. False is a best-effort filter, not a guarantee of a protected through-ticket. |
| `departure_time_range` | object | No | Optional local-hour bounds. Departure hours use origin local time and arrival hours use destination local time. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Round-Trip Fares

**Slug:** `IGNAV_FLIGHTS_SEARCH_ROUND_TRIP_FARES`

Search complete round-trip itineraries between two airport or supported metro IATA codes with outbound and return dates. Returns ranked fares and ignav_id values for booking-link lookup. Each successful call consumes one Ignav usage request and may be charged after the one-time free allowance.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.002 per successful request

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `adults` | integer | No | Number of adult passengers; total passengers across all categories cannot exceed 9. |
| `market` | string ("AE" | "AR" | "AT" | "AU" | "BD" | "BE" | "BG" | "BH" | "BO" | "BR" | "CA" | "CH" | "CL" | "CN" | "CO" | "CR" | "CY" | "CZ" | "DE" | "DK" | "DO" | "EC" | "EE" | "EG" | "ES" | "FI" | "FR" | "GB" | "GH" | "GR" | "GT" | "HK" | "HN" | "HR" | "HU" | "ID" | "IE" | "IL" | "IN" | "IS" | "IT" | "JO" | "JP" | "KE" | "KH" | "KR" | "KW" | "LK" | "LT" | "LU" | "LV" | "MA" | "MT" | "MX" | "MY" | "NG" | "NL" | "NO" | "NP" | "NZ" | "OM" | "PA" | "PE" | "PH" | "PK" | "PL" | "PT" | "PY" | "QA" | "RO" | "RU" | "SA" | "SE" | "SG" | "SI" | "SK" | "SV" | "TH" | "TN" | "TR" | "TW" | "TZ" | "UA" | "UG" | "US" | "UY" | "VN" | "ZA") | No | Provider-supported ISO 3166-1 alpha-2 country market controlling fare availability and currency. |
| `origin` | string | Yes | Outbound departure airport or supported metro IATA code, such as SFO or LON. |
| `children` | integer | No | Number of child passengers. |
| `max_price` | integer | No | Strict maximum total price in the selected market's currency. |
| `max_stops` | integer | No | Maximum stops on each direction (0-2); omit to allow any number. |
| `cabin_class` | string ("economy" | "premium_economy" | "business" | "first") | No | Requested cabin class. |
| `destination` | string | Yes | Outbound arrival airport or supported metro IATA code; must differ from origin. |
| `return_date` | string | Yes | Return date in YYYY-MM-DD format; it must be on or after departure_date. |
| `departure_date` | string | Yes | Outbound date in YYYY-MM-DD format; it cannot be in the past. |
| `infants_on_lap` | integer | No | Number of lap infants; this cannot exceed the adult count. |
| `infants_in_seat` | integer | No | Number of infants occupying seats. |
| `airlines_exclude` | array | No | Non-empty list of 2-character uppercase airline codes to exclude; cannot overlap airlines_include. |
| `airlines_include` | array | No | Non-empty list of 2-character uppercase airline codes to include exclusively; cannot overlap airlines_exclude. |
| `min_checked_bags` | integer | No | Minimum number of included checked bags. |
| `min_carry_on_bags` | integer | No | Minimum number of included carry-on bags. |
| `return_time_range` | object | No | Optional return local-hour bounds. Departure hours use destination local time and arrival hours use origin local time. |
| `allow_self_transfer` | boolean | No | Allow identifiable self-transfers. False is a best-effort filter, not a guarantee of a protected through-ticket. |
| `departure_time_range` | object | No | Optional outbound local-hour bounds. Departure hours use origin local time and arrival hours use destination local time. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |