> Parel documentation. Index of every page: https://parel.si/docs/llms.txt. This page in HTML: https://parel.si/docs/tools/search_flights

# search_flights

> Google Flights options for a route and date: airline, times, stops, duration and price, with the typical fare. ₹1.70 per call; a result that finds nothing is ₹0.

## What it does

What Google Flights shows for a route and dates: data.best_flights[] and data.other_flights[], each with its legs (airline, flight number, departure and arrival airport and time, aircraft), layovers, total_duration in minutes, price and type, plus data.price_insights with lowest_price, price_level and typical_price_range. departure_id and arrival_id are airport codes ("DEL", "BOM"); type 1 is a round trip and needs return_date, type 2 is one way; currency sets the price currency.

Use it to compare fares and timings for a trip or to check what a route costs; for hotels at the destination use [`search_hotels`](https://parel.si/docs/tools/search_hotels.md), for places there [`search_maps`](https://parel.si/docs/tools/search_maps.md). It does not book. Flat price per search; a route with no flights is free. Three to fifteen seconds.

India: currency "INR", airport codes like DEL, BOM, BLR.

## Inputs

Generated from the contract captured from staging on 2026-11-17.

| Field | Type | Required | Description |
|---|---|---|---|
| `type` | string | no | "1" round trip (default, needs return_date), "2" one way. |
| `currency` | string | no | Price currency ("INR", "USD"). Default USD. |
| `arrival_id` | string | yes | The destination airport code ("BOM"). |
| `return_date` | string | no | Return date, YYYY-MM-DD, for a round trip. |
| `departure_id` | string | yes | The origin airport code ("DEL"). |
| `outbound_date` | string | yes | Departure date, YYYY-MM-DD. |

## What drives the cost

Flat per search. type 1 (round trip, the default) needs return_date; type 2 is one way. A result that finds nothing is `class: "ok_free"`, ₹0. The timeout is 41 seconds.

## Price today

| | |
|---|---|
| Price today | **₹1.70** per call (`cost_paise: 170`) at ₹93.93 per US dollar on 17 November 2026 |
| Hold before the call | ₹2.55 (`hold_paise: 255`); when the call settles the real price is charged and the unused part is released |
| ₹0 when | it fails, or the provider answers but there is nothing in it (an empty list, no email, no page): `class: "ok_free"`, ₹0 |
| Timeout | 41 s, then `upstream_timeout` (₹0, retryable) |
| Over MCP | `run_tool` with `tool: "search_flights"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "search_flights"` |
| Confirmation | not needed (the estimate is under the ₹200 threshold) |

## Request

```bash
curl https://api.parel.si/v1/run \
  -H "Authorization: Bearer $PAREL_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tool":"search_flights","input":{"type":"2","currency":"INR","arrival_id":"BOM","departure_id":"DEL","outbound_date":"2026-12-12"}}'
```

## What comes back

`data`, as the live check of 2026-11-17 recorded it, trimmed:

```json
{
  "search_parameters": {
    "engine": "google_flights",
    "hl": "en",
    "gl": "us",
    "type": "2",
    "departure_id": "DEL",
    "arrival_id": "BOM",
    "outbound_date": "2026-12-12",
    "currency": "INR"
  },
  "best_flights": [
    {
      "flights": [
        {
          "departure_airport": {
            "name": "Indira Gandhi International Airport",
            "id": "DEL",
            "time": "2026-12-12 11:00"
          },
          "arrival_airport": {
            "name": "Chhatrapati Shivaji Maharaj International Airport Mumbai",
            "id": "BOM",
            "time": "2026-12-12 13:25"
          },
          "duration": 145,
          "airplane": "Airbus A321neo",
          "airline": "IndiGo",
          "airline_logo": "https://www.gstatic.com/flights/airline_logos/70px/6E.png",
          "travel_class": "Economy",
          "flight_number": "6E 6047",
          "legroom": "28 in",
          "extensions": [
            "Below average legroom (28 in)",
            "Carbon emissions estimate: 83 kg"
          ]
        }
      ],
      "total_duration": 145,
      "carbon_emissions": {
        "this_flight": 83000,
        "typical_for_this_route": 100000,
        "difference_percent": -17
      },
      "price": 6551,
      "type": "One way",
      "airline_logo": "https://www.gstatic.com/flights/airline_logos/70px/6E.png",
      "booking_token": "WyJDalJJU1hSeVkwcExXRkpWVkhkQlFWTTVNMEZDUnkwdExTMHRMUzB0TFhsc2Ftd3hPVUZCUVVGQlIzSTNZVkZyVG5OVFEwRkJFZ1kyUlRZd05EY2FDZ2lYTXhBQUdnTkpUbEk0SEhEQk5nPT0iLFtbIkRFTCIsIjIwMjYtMTItMTIiLCJCT00iLG51bGwsIjZFIiwiNjA0NyJdXV0="
    },
    {
      "flights": [
        {
          "departure_airport": {
            "name": "Indira Gandhi International Airport",
            "id": "DEL",
            "time": "2026-12-12 05:30"
          },
          "arrival_airport": {
            "name": "Chhatrapati Shivaji Maharaj International Airport Mumbai",
            "id": "BOM",
            "time": "2026-12-12 07:55"
          },
          "duration": 145,
          "airplane": "Airbus A321",
          "airline": "Air India",
          "airline_logo": "https://www.gstatic.com/flights/airline_logos/70px/AI.png",
          "travel_class": "Economy",
          "flight_number": "AI 2573",
          "legroom": "29 in",
          "extensions": [
            "Below average legroom (29 in)",
            "Wi-Fi for a fee",
            "In-seat power & USB outlets"
          ]
        }
      ],
      "total_duration": 145,
      "carbon_emissions": {
        "this_flight": 123000,
        "typical_for_this_route": 100000,
        "difference_percent": 23
      },
      "price": 7019,
      "type": "One way",
      "airline_logo": "https://www.gstatic.com/flights/airline_logos/70px/AI.png",
      "booking_token": "WyJDalJJU1hSeVkwcExXRkpWVkhkQlFWTTVNMEZDUnkwdExTMHRMUzB0TFhsc2Ftd3hPVUZCUVVGQlIzSTNZVkZyVG5OVFEwRkJFZ1pCU1RJMU56TWFDZ2pyTmhBQUdnTkpUbEk0SEhDME9nPT0iLFtbIkRFTCIsIjIwMjYtMTItMTIiLCJCT00iLG51bGwsIkFJIiwiMjU3MyJdXV0="
    },
    {
      "flights": [
        {
          "departure_airport": {
            "name": "Indira Gandhi International Airport",
            "id": "DEL",
            "time": "2026-12-12 21:45"
          },
          "arrival_airport": {
            "name": "Chhatrapati Shivaji Maharaj International Airport Mumbai",
            "id": "BOM",
            "time": "2026-12-13 00:10"
          },
          "duration": 145,
          "airplane": "Boeing 737MAX 8 Passenger",
          "airline": "Akasa Air",
          "airline_logo": "https://www.gstatic.com/flights/airline_logos/70px/QP.png",
          "travel_class": "Economy",
          "flight_number": "QP 1116",
          "legroom": "28 in",
          "extensions": [
            "Below average legroom (28 in)",
            "In-seat USB outlet",
            "Carbon emissions estimate: 81 kg"
          ],
          "often_delayed_by_over_30_min": true
        }
      ],
      "total_duration": 145,
      "carbon_emissions": {
        "this_flight": 81000,
        "typical_for_this_route": 100000,
        "difference_percent": -19
      },
      "price": 7229,
      "type": "One way",
      "airline_logo": "https://www.gstatic.com/flights/airline_logos/70px/QP.png",
      "booking_token": "WyJDalJJU1hSeVkwcExXRkpWVkhkQlFWTTVNMEZDUnkwdExTMHRMUzB0TFhsc2Ftd3hPVUZCUVVGQlIzSTNZVkZyVG5OVFEwRkJFZ1pSVURFeE1UWWFDZ2k5T0JBQUdnTkpUbEk0SEhDVFBBPT0iLFtbIkRFTCIsIjIwMjYtMTItMTIiLCJCT00iLG51bGwsIlFQIiwiMTExNiJdXV0="
    }
  ],
  "other_flights": [
    {
      "flights": [
        {
          "departure_airport": {
            "name": "Indira Gandhi International Airport",
            "id": "DEL",
            "time": "2026-12-12 03:30"
          },
          "arrival_airport": {
            "name": "Chhatrapati Shivaji Maharaj International Airport Mumbai",
            "id": "BOM",
            "time": "2026-12-12 05:55"
          },
          "duration": 145,
          "airplane": "Airbus A321neo",
          "airline": "IndiGo",
          "airline_logo": "https://www.gstatic.com/flights/airline_logos/70px/6E.png",
          "travel_class": "Economy",
          "flight_number": "6E 353",
          "legroom": "28 in",
          "extensions": [
            "Below average legroom (28 in)",
            "Carbon emissions estimate: 83 kg"
          ],
          "overnight": true
        }
      ],
      "total_duration": 145,
      "carbon_emissions": {
        "this_flight": 83000,
        "typical_for_this_route": 100000,
        "difference_percent": -17
      },
      "price": 6551,
      "type": "One way",
      "airline_logo": "https://www.gstatic.com/flights/airline_logos/70px/6E.png",
      "booking_token": "WyJDalJJU1hSeVkwcExXRkpWVkhkQlFWTTVNMEZDUnkwdExTMHRMUzB0TFhsc2Ftd3hPVUZCUVVGQlIzSTNZVkZyVG5OVFEwRkJFZ1UyUlRNMU14b0tDSmN6RUFBYUEwbE9VamdjY01FMiIsW1siREVMIiwiMjAyNi0xMi0xMiIsIkJPTSIsbnVsbCwiNkUiLCIzNTMiXV1d"
    },
    {
      "flights": [
        {
          "departure_airport": {
            "name": "Indira Gandhi International Airport",
            "id": "DEL",
            "time": "2026-12-12 05:00"
          },
          "arrival_airport": {
            "name": "Chhatrapati Shivaji Maharaj International Airport Mumbai",
            "id": "BOM",
            "time": "2026-12-12 07:25"
          },
          "duration": 145,
          "airplane": "Airbus A321neo",
          "airline": "IndiGo",
          "airline_logo": "https://www.gstatic.com/flights/airline_logos/70px/6E.png",
          "travel_class": "Economy",
          "flight_number": "6E 449",
          "legroom": "28 in",
          "extensions": [
            "Below average legroom (28 in)",
            "Carbon emissions estimate: 83 kg"
          ]
        }
      ],
      "total_duration": 145,
      "carbon_emissions": {
        "this_flight": 83000,
        "typical_for_this_route": 100000,
        "difference_percent": -17
      },
      "price": 6551,
      "type": "One way",
      "airline_logo": "https://www.gstatic.com/flights/airline_logos/70px/6E.png",
      "booking_token": "WyJDalJJU1hSeVkwcExXRkpWVkhkQlFWTTVNMEZDUnkwdExTMHRMUzB0TFhsc2Ftd3hPVUZCUVVGQlIzSTNZVkZyVG5OVFEwRkJFZ1UyUlRRME9Sb0tDSmN6RUFBYUEwbE9VamdjY01FMiIsW1siREVMIiwiMjAyNi0xMi0xMiIsIkJPTSIsbnVsbCwiNkUiLCI0NDkiXV1d"
    },
    {
      "flights": [
        {
          "departure_airport": {
            "name": "Indira Gandhi International Airport",
            "id": "DEL",
            "time": "2026-12-12 06:05"
          },
          "arrival_airport": {
            "name": "Chhatrapati Shivaji Maharaj International Airport Mumbai",
            "id": "BOM",
            "time": "2026-12-12 08:25"
          },
          "duration": 140,
          "airplane": "Airbus A321neo",
          "airline": "IndiGo",
          "airline_logo": "https://www.gstatic.com/flights/airline_logos/70px/6E.png",
          "travel_class": "Economy",
          "flight_number": "6E 6218",
          "legroom": "28 in",
          "extensions": [
            "Below average legroom (28 in)",
            "Carbon emissions estimate: 83 kg"
          ]
        }
      ],
      "total_duration": 140,
      "carbon_emissions": {
        "this_flight": 83000,
        "typical_for_this_route": 100000,
        "difference_percent": -17
      },
      "price": 6551,
      "type": "One way",
      "airline_logo": "https://www.gstatic.com/flights/airline_logos/70px/6E.png",
      "booking_token": "WyJDalJJU1hSeVkwcExXRkpWVkhkQlFWTTVNMEZDUnkwdExTMHRMUzB0TFhsc2Ftd3hPVUZCUVVGQlIzSTNZVkZyVG5OVFEwRkJFZ1kyUlRZeU1UZ2FDZ2lYTXhBQUdnTkpUbEk0SEhEQk5nPT0iLFtbIkRFTCIsIjIwMjYtMTItMTIiLCJCT00iLG51bGwsIjZFIiwiNjIxOCJdXV0="
    }
  ],
  "price_insights": {
    "lowest_price": 6551,
    "price_level": "typical",
    "typical_price_range": [
      5800,
      7000
    ],
    "price_history": [
      [
        1789669800,
        6620
      ],
      [
        1789756200,
        6620
      ],
      [
        1789842600,
        6620
      ]
    ]
  },
  "airports": [
    {
      "departure": [
        {
          "airport": {
            "id": "DEL",
            "name": "Indira Gandhi International Airport"
          },
          "city": "New Delhi",
          "country": "India",
          "country_code": "IN",
          "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRkRqzwP-0z4pH29-KifVzfrxM5wwXx56g3Hoo_ebldH9Fy8a8EjGqPzd3fZqJSKoE5tSIRC2iGJxgqzQ",
          "thumbnail": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSY7HqndXM-ihFCu1qUKosYR--X_yXSd-0mkQHeSUaG5rkpq5Y6uxD8CMmYUCdngZE7mV0onuN2zv_aVxGGO8xv4FMcpMlWvbXdvJFcemY"
        }
      ],
      "arrival": [
        {
          "airport": {
            "id": "BOM",
            "name": "Chhatrapati Shivaji Maharaj International Airport Mumbai"
          },
          "city": "Mumbai",
          "country": "India",
          "country_code": "IN",
          "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTJ5Q0R5IIxjWsuWKt6lnlBIOlNfNwTqC8yBtOP_uMdzFrluYmn3jZ-6dyEWo6AbIH3x57scrUgF3gvWA",
          "thumbnail": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcRMqVWevN4qkQ8u4HrxtHbv2Oy7UigPckL8bgZUJQWQgjvmJxG7oggYxd2Rw5MwjiBYzZFpr939opSbON9CxkwdD-7DK9it3TPq1ea8pxU"
        }
      ]
    }
  ]
}
```

## Notes

- Flat per search. type 1 (round trip, the default) needs return_date; type 2 is one way.
- Airport codes, not city names: DEL, BOM, BLR, DXB.
- Prices are Google's quotes for the dates given and change quickly; nothing is held or booked.

## Siblings

- [`search_hotels`](https://parel.si/docs/tools/search_hotels.md)
- [`search_maps`](https://parel.si/docs/tools/search_maps.md)
