Google Flights Calendar

Name: Google Flights Calendar
Price: 0.01 USD
Availability: InStock
Author: Google Flights

https://api.sandbase.ai/v1/api/google-flights/calendar

Get the lowest Google Flights fare for each departure date in a range between two airports, for one-way or round trips.

Price: $0.01USD / call
Method: POST
Response: JSON
Parameters: 2 required · 19 optional

Input

Departure Id(string)

Parameter defines the departure airport code or location kgmid. An airport code is an uppercase 3-letter code. You can search for it on Google Flights or IATA. For example, `CDG` is Paris Charles de Gaulle Airport and `AUS` is Austin-Bergstrom International Airport. A location kgmid is a string that starts with `/m/`. You can search for a location on Wikidata and use its "Freebase ID" as the location kgmid. For example, `/m/0vzm` is the location kgmid for Austin, TX.

Arrival Id(string)

Parameter defines the arrival airport code or location kgmid. An airport code is an uppercase 3-letter code. You can search for it on Google Flights or IATA. For example, `CDG` is Paris Charles de Gaulle Airport and `AUS` is Austin-Bergstrom International Airport. A location kgmid is a string that starts with `/m/`. You can search for a location on Wikidata and use its "Freebase ID" as the location kgmid. For example, `/m/0vzm` is the location kgmid for Austin, TX.

Gl(string)

Parameter defines the country to use for the Google Flights search. It's a two-letter country code. (e.g., `us` for the United States, `uk` for United Kingdom, or `fr` for France) Head to the Google countries page for a full list of supported Google countries.

Hl(string)

Parameter defines the language to use for the Google Flights search. It's a two-letter language code. (e.g., `en` for English, `es` for Spanish, or `fr` for French). Head to the Google languages page for a full list of supported Google languages.

Currency(string)

Parameter defines the currency of the returned prices. Default to `USD`. Head to the Google Travel Currencies page for a full list of supported currency codes.

Type(string)

Parameter defines the type of the flights. Available options: `1` - Round trip (default) `2` - One way

Date Range Start(string)

Parameter defines the start date of the date range. The format is YYYY-MM-DD. e.g. `2026-11-12` Default to today's date. When `fixed_outbound_date` is set to `true`, this date is also used as the outbound date.

Date Range End(string)

Parameter defines the end date of the date range. The format is YYYY-MM-DD. e.g. `2026-12-31` Default to end of next month.

Round Trip Days(string)

Parameter defines the number of days for the round trip. Default to 7. It can only be used in combination with `type` parameter set to `1` (Round trip). Parameter cannot be used with `fixed_outbound_date` parameter.

Fixed Outbound Date(string)

Parameter defines whether the outbound date is fixed. It can be set to `true` to depart on `date_range_start` and get a price for each return date in the date range, or `false` (default) to get a price for each outbound date in the date range with a trip length of `round_trip_days`. It can only be used in combination with `type` parameter set to `1` (Round trip). Parameter cannot be used with `round_trip_days` parameter.

Travel Class(string)

Parameter defines the travel class. Available options: `1` - Economy (default) `2` - Premium economy `3` - Business `4` - First

Adults(string)

Parameter defines the number of adults. Default to 1.

Children(string)

Parameter defines the number of children. Default to 0.

Infants In Seat(string)

Parameter defines the number of infants in seat. Default to 0.

Infants On Lap(string)

Parameter defines the number of infants on lap. Default to 0.

Stops(string)

Parameter defines the number of stops during the flight. Available options: `0` - Any number of stops (default) `1` - Nonstop only `2` - 1 stop or fewer `3` - 2 stops or fewer

Exclude Airlines(string)

Parameter defines the airline codes to be excluded. Split multiple airlines with comma. It can't be used together with `include_airlines`. Each airline code should be a 2-character IATA code consisting of either two uppercase letters or one uppercase letter and one digit. You can search for airline codes on IATA. For example, `UA` is United Airlines. Additionally, alliances can be also included here: `STAR_ALLIANCE` - Star Alliance `SKYTEAM` - SkyTeam `ONEWORLD` - Oneworld `exclude_airlines` and `include_airlines` parameters can't be used together.

Include Airlines(string)

Parameter defines the airline codes to be included. Split multiple airlines with comma. It can't be used together with `exclude_airlines`. Each airline code should be a 2-character IATA code consisting of either two uppercase letters or one uppercase letter and one digit. You can search for airline codes on IATA. For example, `UA` is United Airlines. Additionally, alliances can be also included here: `STAR_ALLIANCE` - Star Alliance `SKYTEAM` - SkyTeam `ONEWORLD` - Oneworld `exclude_airlines` and `include_airlines` parameters can't be used together.

Outbound Times(string)

Parameter defines the outbound times range. It's a string containing two (for departure only) or four (for departure and arrival) comma-separated numbers. Each number represents the beginning of an hour. For example: `4,18`: 4:00 AM - 7:00 PM departure `0,18`: 12:00 AM - 7:00 PM departure `19,23`: 7:00 PM - 12:00 AM departure `4,18,3,19`: 4:00 AM - 7:00 PM departure, 3:00 AM - 8:00 PM arrival `0,23,3,19`: unrestricted departure, 3:00 AM - 8:00 PM arrival

Return Times(string)

Parameter defines the return times range. It's a string containing two (for departure only) or four (for departure and arrival) comma-separated numbers. Each number represents the beginning of an hour. For example: `4,18`: 4:00 AM - 7:00 PM departure `0,18`: 12:00 AM - 7:00 PM departure `19,23`: 7:00 PM - 12:00 AM departure `4,18,3,19`: 4:00 AM - 7:00 PM departure, 3:00 AM - 8:00 PM arrival `0,23,3,19`: unrestricted departure, 3:00 AM - 8:00 PM arrival Parameter should only be used when `type` parameter is set to: `1` (Round trip)

Json Restrictor(string)

Parameter defines the fields you want to include in the output, reducing payload size for faster response. See the JSON Restrictor documentation for more details.

OutputReady

Your output will appear here

Complete the inputs, then click Run.

API README

Google Flights Calendar

Get the lowest Google Flights fare for each departure date in a range between two airports, for one-way or round trips.

Request

curl -X POST "https://api.sandbase.ai/v1/api/google-flights/calendar" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"departure_id": "AUS", "arrival_id": "JFK"}'

The result is returned in outputs[0].data as structured JSON.

Parameters

Name	Type	Required	Description
`departure_id`	string	Yes	Parameter defines the departure airport code or location kgmid. An airport code is an uppercase 3-letter code. You can search for it on Google Flights or IATA. For example, `CDG` is Paris Charles de Gaulle Airport and `AUS` is Austin-Bergst
`arrival_id`	string	Yes	Parameter defines the arrival airport code or location kgmid. An airport code is an uppercase 3-letter code. You can search for it on Google Flights or IATA. For example, `CDG` is Paris Charles de Gaulle Airport and `AUS` is Austin-Bergstro
`gl`	string	No	Parameter defines the country to use for the Google Flights search. It's a two-letter country code. (e.g., `us` for the United States, `uk` for United Kingdom, or `fr` for France) Head to the Google countries page for a full list of support
`hl`	string	No	Parameter defines the language to use for the Google Flights search. It's a two-letter language code. (e.g., `en` for English, `es` for Spanish, or `fr` for French). Head to the Google languages page for a full list of supported Google lang
`currency`	string	No	Parameter defines the currency of the returned prices. Default to `USD`. Head to the Google Travel Currencies page for a full list of supported currency codes.
`type`	string	No	Parameter defines the type of the flights. Available options: `1` - Round trip (default) `2` - One way
`date_range_start`	string	No	Parameter defines the start date of the date range. The format is YYYY-MM-DD. e.g. `2026-11-12` Default to today's date. When `fixed_outbound_date` is set to `true`, this date is also used as the outbound date.
`date_range_end`	string	No	Parameter defines the end date of the date range. The format is YYYY-MM-DD. e.g. `2026-12-31` Default to end of next month.
`round_trip_days`	string	No	Parameter defines the number of days for the round trip. Default to 7. It can only be used in combination with `type` parameter set to `1` (Round trip). Parameter cannot be used with `fixed_outbound_date` parameter.
`fixed_outbound_date`	string	No	Parameter defines whether the outbound date is fixed. It can be set to `true` to depart on `date_range_start` and get a price for each return date in the date range, or `false` (default) to get a price for each outbound date in the date ran
`travel_class`	string	No	Parameter defines the travel class. Available options: `1` - Economy (default) `2` - Premium economy `3` - Business `4` - First
`adults`	string	No	Parameter defines the number of adults. Default to 1.
`children`	string	No	Parameter defines the number of children. Default to 0.
`infants_in_seat`	string	No	Parameter defines the number of infants in seat. Default to 0.
`infants_on_lap`	string	No	Parameter defines the number of infants on lap. Default to 0.
`stops`	string	No	Parameter defines the number of stops during the flight. Available options: `0` - Any number of stops (default) `1` - Nonstop only `2` - 1 stop or fewer `3` - 2 stops or fewer
`exclude_airlines`	string	No	Parameter defines the airline codes to be excluded. Split multiple airlines with comma. It can't be used together with `include_airlines`. Each airline code should be a 2-character IATA code consisting of either two uppercase letters or one
`include_airlines`	string	No	Parameter defines the airline codes to be included. Split multiple airlines with comma. It can't be used together with `exclude_airlines`. Each airline code should be a 2-character IATA code consisting of either two uppercase letters or one
`outbound_times`	string	No	Parameter defines the outbound times range. It's a string containing two (for departure only) or four (for departure and arrival) comma-separated numbers. Each number represents the beginning of an hour. For example: `4,18`: 4:00 AM - 7:00
`return_times`	string	No	Parameter defines the return times range. It's a string containing two (for departure only) or four (for departure and arrival) comma-separated numbers. Each number represents the beginning of an hour. For example: `4,18`: 4:00 AM - 7:00 PM
`json_restrictor`	string	No	Parameter defines the fields you want to include in the output, reducing payload size for faster response. See the JSON Restrictor documentation for more details.

Pricing

$0.010 per successful call. Failed calls are not charged.

Start building

Send your first request

Platform API endpoint with unified authentication and usage tracking.

Production API

Platform API endpoint

https://api.sandbase.ai/v1/api/google-flights/calendar

Authorization header

Authorization: Bearer $SANDBASE_API_KEY

# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
  -X POST "https://api.sandbase.ai/v1/api/google-flights/calendar" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "arrival_id": "JFK",
  "departure_id": "AUS"
}
SANDBASE_JSON
)
printf '%s\n' "$result"

2. Authentication

Set your SandBase API key in your server environment. Requests use Bearer authentication.

API key environment variable

export SANDBASE_API_KEY="YOUR_API_KEY"

Keep your key on the server. Do not expose it in browser code.

3. Parameters

`departure_id`stringrequired

`arrival_id`stringrequired

`gl`string

`hl`string

`currency`string

Parameter defines the currency of the returned prices. Default to `USD`. Head to the Google Travel Currencies page for a full list of supported currency codes.

`type`string

Parameter defines the type of the flights. Available options: `1` - Round trip (default) `2` - One way

`date_range_start`string

`date_range_end`string

Parameter defines the end date of the date range. The format is YYYY-MM-DD. e.g. `2026-12-31` Default to end of next month.

`round_trip_days`string

`fixed_outbound_date`string

`travel_class`string

Parameter defines the travel class. Available options: `1` - Economy (default) `2` - Premium economy `3` - Business `4` - First

`adults`string

Parameter defines the number of adults. Default to 1.

`children`string

Parameter defines the number of children. Default to 0.

`infants_in_seat`string

Parameter defines the number of infants in seat. Default to 0.

`infants_on_lap`string

Parameter defines the number of infants on lap. Default to 0.

`stops`string

Parameter defines the number of stops during the flight. Available options: `0` - Any number of stops (default) `1` - Nonstop only `2` - 1 stop or fewer `3` - 2 stops or fewer

`exclude_airlines`string

`include_airlines`string

`outbound_times`string

`return_times`string

`json_restrictor`string

Parameter defines the fields you want to include in the output, reducing payload size for faster response. See the JSON Restrictor documentation for more details.

4. Response

Saved example response for this API; no live request is made when viewing it.

No saved response has been published. Run the API in Playground to inspect its response.

Explore more

Related APIs

All APIs

API	Price	Response
Google Flights CalendarThis API `Google Flights`	$0.01 per call	JSON
Google Flights Autocomplete `Google Flights`	$0.01 per call	JSON
Google Flights Deals `Google Flights`	$0.01 per call	JSON
Google Flights Search `Google Flights`	$0.015 per call	JSON

Questions

FAQ

How do I use the Google Flights Calendar API?

Send a POST request to https://api.sandbase.ai/v1/api/google-flights/calendar with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.

How much does the Google Flights Calendar API cost?

$0.01 per call, billed from your SandBase balance. You are only charged for calls you make; there is no subscription.

What parameters does the Google Flights Calendar API accept?

Required: departure_id (string) and arrival_id (string). Optional: gl (string), hl (string), currency (string), type (string), date_range_start (string) and date_range_end (string) and 13 more. The Parameters table and the Playground on this page list every field.

What does the Google Flights Calendar API return?

A JSON response returned in the same HTTP request (synchronous).

Do I need a Google Flights developer account or API key?

No. Google Flights Calendar runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for Google Flights API access separately.

Google Flights Calendar

Playground

API README

Google Flights Calendar

Request

Parameters

Pricing

Send your first request

2. Authentication

3. Parameters

departure_idstringrequired

arrival_idstringrequired

glstring

hlstring

currencystring

typestring

date_range_startstring

date_range_endstring

round_trip_daysstring

fixed_outbound_datestring

travel_classstring

adultsstring

childrenstring

infants_in_seatstring

infants_on_lapstring

stopsstring

exclude_airlinesstring

include_airlinesstring

outbound_timesstring

return_timesstring

json_restrictorstring

4. Response

Related APIs

FAQ

`departure_id`stringrequired

`arrival_id`stringrequired

`gl`string

`hl`string

`currency`string

`type`string

`date_range_start`string

`date_range_end`string

`round_trip_days`string

`fixed_outbound_date`string

`travel_class`string

`adults`string

`children`string

`infants_in_seat`string

`infants_on_lap`string

`stops`string

`exclude_airlines`string

`include_airlines`string

`outbound_times`string

`return_times`string

`json_restrictor`string