Get round-trip date grid (v1)
Get the cheapest round-trip fare for each departure and return date pair within three days of the given dates: up to 49 pairs.
1 credit / requestBilled only on success
Authorization
ApiKeyAuth x-api-key<token>
In: header
Query Parameters
origin*string
Departure airport IATA code(s).
destination*string
Arrival airport IATA code(s).
departure_date*string
Center of the outbound range; the grid spans three days either side.
Match
^\d{4}-\d{2}-\d{2}$return_date*string
Center of the return range; the grid spans three days either side.
Match
^\d{4}-\d{2}-\d{2}$adults?integer
Range
1 <= value <= 9Default
1children?|
Range
0 <= value <= 8Default
0infants_in_seat?|
Range
0 <= value <= 8Default
0infants_on_lap?|
At most one per adult.
Range
0 <= value <= 8Default
0cabin?string
Default
"economy"Value in
- "economy"
- "premium_economy"
- "business"
- "first"
stops?string
Most stops allowed: one_stop means one stop or fewer, two_stops two or fewer.
Default
"any"Value in
- "any"
- "nonstop"
- "one_stop"
- "two_stops"
currency?string
ISO 4217 currency for prices.
Match
^[A-Za-z]{3}$Default
"USD"curl -X GET "https://example.com/v1/google-flights/date-grid?origin=JFK&destination=LAX&departure_date=2026-12-10&return_date=2026-12-17" \ -H "x-api-key: YOUR_API_KEY"{ "data": { "currency": "string", "cells": [ { "departure_date": "string", "return_date": "string", "price": 0 } ] }, "details": { "reason": "string", "message": "string" }}