> ## Documentation Index
> Fetch the complete documentation index at: https://mindcase.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Flights

> Search Google Flights for one-way, round-trip, and multi-city flights, including prices, stops, airlines, and passenger counts

`$0.1 / 1k flights`

Search Google Flights for one-way, round-trip, and multi-city flights, including prices, stops, airlines, and passenger counts

## Endpoint

`POST /api/v1/agents/google/flights/run`

## Parameters

<ParamField body="departure" type="array" required>
  **List** · Departure airport codes (e.g. LAX, JFK). One per line.
</ParamField>

<ParamField body="arrival" type="array" required>
  **List** · Arrival airport codes (e.g. JFK, SFO). One per line.
</ParamField>

<ParamField body="outboundDate" type="date" required>
  **Date picker** · Date of departure flight.
</ParamField>

<ParamField body="returnDate" type="date">
  **Date picker** · Date of return flight. Leave blank for one-way.
</ParamField>

<ParamField body="adults" type="integer" default={1}>
  **Number** · Number of adult passengers.
</ParamField>

<ParamField body="children" type="integer" default={0}>
  **Number** · Number of children (ages 2-11).
</ParamField>

<ParamField body="infants" type="integer" default={0}>
  **Number** · Number of infants (under 2).
</ParamField>

<ParamField body="currency" type="string" default="USD">
  **Dropdown** · Currency for prices.

  [View all 32 options →](/agents/google/flights/values#currency)
</ParamField>

<ParamField body="country" type="string" default="us">
  **Dropdown** · Country to search Google Flights from.

  [View all 37 options →](/agents/google/flights/values#country)
</ParamField>

<ParamField body="language" type="string" default="en">
  **Dropdown** · Language for results.

  <Accordion title="Show all 22 options">
    `en`, `es`, `fr`, `de`, `it`, `pt`, `nl`, `sv`, `tr`, `ru`, `pl`, `el`, `he`, `ar`, `hi`, `zh`, `ja`, `ko`, `th`, `vi`, `id`, `ms`

    *Legend: `en` = English, `es` = Spanish, `fr` = French, `de` = German, `it` = Italian, `pt` = Portuguese, `nl` = Dutch, `sv` = Swedish, `tr` = Turkish, `ru` = Russian, `pl` = Polish, `el` = Greek, `he` = Hebrew, `ar` = Arabic, `hi` = Hindi, `zh` = Chinese, `ja` = Japanese, `ko` = Korean, `th` = Thai, `vi` = Vietnamese, `id` = Indonesian, `ms` = Malay*

    [View all 22 as a structured list →](/agents/google/flights/values#language)
  </Accordion>
</ParamField>

<ParamField body="maxPrice" type="integer">
  **Number** · Cap results below this price (in selected currency).
</ParamField>

<ParamField body="maxStops" type="string">
  **Dropdown** · Maximum number of stops. Leave blank for any.

  **Options:** `0`, `1`, `2`

  *Legend: `0` = Direct only, `1` = Up to 1 stop, `2` = Up to 2 stops*
</ParamField>

<ParamField body="airlines" type="array">
  **List** · Airline IATA codes (e.g. UA, AA, DL). One per line.
</ParamField>

<ParamField body="excludeBasic" type="boolean" default={false}>
  **Toggle** · Filter out Basic Economy fares (no carry-on, no seat selection).
</ParamField>

## Response columns

| Field              | Display name      | Type       |
| ------------------ | ----------------- | ---------- |
| `origin`           | Origin            | text       |
| `destination`      | Destination       | text       |
| `outboundDate`     | Outbound Date     | date       |
| `returnDate`       | Return Date       | date       |
| `tier`             | Tier              | text       |
| `tripType`         | Trip Type         | text       |
| `priceUsd`         | Price (USD)       | number     |
| `durationMin`      | Duration (min)    | number     |
| `stops`            | Stops             | number     |
| `airline`          | Airline           | text       |
| `airlineLogo`      | Airline Logo      | url        |
| `airplane`         | Airplane          | text       |
| `travelClass`      | Travel Class      | text       |
| `flightNumber`     | Flight Number     | text       |
| `legroom`          | Legroom           | text       |
| `departureAirport` | Departure Airport | text       |
| `departureTime`    | Departure Time    | text       |
| `arrivalAirport`   | Arrival Airport   | text       |
| `arrivalTime`      | Arrival Time      | text       |
| `carbonKg`         | Carbon (kg)       | number     |
| `carbonVsTypical`  | Carbon vs Typical | percentage |
| `extensions`       | Extensions        | array      |
| `allFlights`       | All Flights       | array      |

## Example

<CodeGroup>
  ```bash curl theme={null}
  curl -X POST https://api.mindcase.co/api/v1/agents/google/flights/run \
    -H "Authorization: Bearer mk_live_abc123def456" \
    -H "Content-Type: application/json" \
    -d '{
    "params": {
      "departure": [
        "LAX"
      ],
      "arrival": [
        "JFK"
      ],
      "outboundDate": "2026-06-15",
      "returnDate": "2026-06-22",
      "currency": "USD",
      "language": "en",
      "country": "us",
      "adults": 1,
      "maxPages": 5,
      "output_file": "google_flights_results.json"
    }
  }'
  ```

  ```python Python theme={null}
  import requests

  resp = requests.post(
      "https://api.mindcase.co/api/v1/agents/google/flights/run",
      headers={"Authorization": "Bearer mk_live_abc123def456"},
      json={"params": {
      "departure": [
          "LAX"
      ],
      "arrival": [
          "JFK"
      ],
      "outboundDate": "2026-06-15",
      "returnDate": "2026-06-22",
      "currency": "USD",
      "language": "en",
      "country": "us",
      "adults": 1,
      "maxPages": 5,
      "output_file": "google_flights_results.json"
  }},
  )
  data = resp.json()
  ```
</CodeGroup>

### Example response

```json Response theme={null}
{
  "job_id": "job_7f3a2b1c",
  "status": "completed",
  "data": [
    {
      "origin": "LAX",
      "destination": "JFK",
      "outboundDate": "2026-06-15",
      "returnDate": "2026-06-22",
      "tier": "Best",
      "tripType": "Round trip",
      "priceUsd": 512,
      "durationMin": 337,
      "stops": 0,
      "airline": "JetBlue",
      "airlineLogo": "https://www.gstatic.com/flights/airline_logos/70px/B6.png",
      "airplane": "Airbus A320",
      "travelClass": "Economy",
      "flightNumber": "B6 824",
      "legroom": "33 in",
      "departureAirport": "LAX",
      "departureTime": "2026-06-15 16:20",
      "arrivalAirport": "JFK",
      "arrivalTime": "2026-06-16 00:57",
      "carbonKg": 409000,
      "carbonVsTypical": 20,
      "extensions": [
        "Checked baggage for a fee",
        "Bag and fare conditions depend on the return flight"
      ],
      "allFlights": [
        {
          "departure_airport": {
            "name": "Los Angeles International Airport",
            "id": "LAX",
            "time": "2026-06-15 16:20"
          },
          "arrival_airport": {
            "name": "John F. Kennedy International Airport",
            "id": "JFK",
            "time": "2026-06-16 00:57"
          },
          "duration": 337,
          "airplane": "Airbus A320",
          "airline": "JetBlue",
          "airline_logo": "https://www.gstatic.com/flights/airline_logos/70px/B6.png",
          "travel_class": "Economy",
          "flight_number": "B6 824",
          "legroom": "33 in",
          "extensions": [
            "Above average legroom (33 in)",
            "Free Wi-Fi",
            "In-seat power & USB outlets",
            "Live TV",
            "Carbon emissions estimate: 409 kg"
          ]
        }
      ]
    }
  ]
}
```