# Return and next-leg flights: `POST /v1/serp/google_flights_return`

Cost: 4 credits (4 (failed requests are free)). Docs: https://scrapercompany.com/docs/reference/google-flights-return

The return flights for a chosen outbound (or the next multi-city leg).

SerpApi's `departure_token` flow: pass the `departure_token`
of an itinerary from `/v1/serp/google_flights`. Prices are for the whole
trip, as Google shows them. Last-leg options carry a `booking_token`.

Request body (JSON):

- `departure_token` (string; required; pattern ^gf1\.[A-Za-z0-9_\-]{16,16384}$): `departure_token` of an itinerary from `/v1/serp/google_flights` (or of a previous `/v1/serp/google_flights_return` leg of a multi-city trip). It carries the search, so nothing else is needed.

Response fields:

- `departure_airport` (string; required): Origin of the leg these options are for: airport codes or Google city ids, comma-separated.
- `arrival_airport` (string; required): Destination of the leg these options are for: airport codes or Google city ids, comma-separated.
- `departure_date` (string (date); required): Date of the leg these options are for (the return date of a round trip).
- `return_date` (string (date); optional): Present only for round trips (the same date as `departure_date`).
- `currency` (string; required): The requested currency.
- `adults` (integer; required)
- `itineraries` (array of object; required): Options for the leg being chosen: Google's best flights first, then the others.
  - `itineraries[].legs` (array of object; required): The leg chosen in this call (one entry). Earlier legs are not repeated; `/v1/serp/google_flights_booking` returns every leg.
  - `itineraries[].price` (number | null; required): Google's displayed whole amount for the whole trip (every leg, all passengers), in `currency`. Google rounds up (527 where the exact fare is 526.19; see `price_exact`). When `priced_in` is set, the amount is in that currency instead.
  - `itineraries[].currency` (string; required): The requested currency.
  - `itineraries[].display_price` (string | null; required): `price` with its currency symbol, e.g. `$527`. Null when `price` is null or `priced_in` is set.
  - `itineraries[].booking_token` (string | null; required): Pass to `POST /v1/serp/google_flights_booking` for sellers, prices and booking links. Set only on complete itineraries (one-way options, and the options of a trip's last leg); null when `departure_token` is set. Compatibility: until 2026-09-30 this field held Google's raw price token on every itinerary; that value is now `price_token`.
  - `itineraries[].booking_url` (string | null; required): Google Flights booking page for the complete itinerary. Set together with `booking_token`.
  - `itineraries[].carbon_emissions_kg` (integer | null; required): CO2e estimate for this itinerary, kilograms (rounded). `carbon_emissions` has the same figure in grams.
  - `itineraries[].carbon_emissions_comparison` (string | null; required): e.g. `19% lower than typical` or `typical for this route`.
  - `itineraries[].trip_type` (string; required; one of one_way, round_trip, multi_city): `one_way`, `round_trip` or `multi_city`.
  - `itineraries[].total_stops` (integer; required): Stops across `legs`.
  - `itineraries[].is_direct` (boolean; required): `total_stops` is 0.
  - `itineraries[].departure_token` (string | null; required): Pass to `POST /v1/serp/google_flights_return` for the next leg's options after choosing this one. Set while legs remain to choose (round-trip outbound, multi-city legs before the last); null when `booking_token` is set. Self-contained: nothing else is needed with it.
  - `itineraries[].google_flights_url` (string | null; required): Google Flights page for this option: the search page with the earlier legs chosen, or the booking page once every leg is chosen.
  - `itineraries[].group` (string; required; one of best, other): `best` (Google's top flights) or `other`. Every option is `other` when `sort_by` is not `top_flights`.
  - `itineraries[].price_exact` (number | null; required): Price with minor units, from Google's price token (526.19 where `price` is 527). Null when the token has no amount or is in another currency.
  - `itineraries[].price_token` (string | null; required): Google's own opaque price token for this option, on every itinerary (returned as `booking_token` until 2026-09-30). Usable as an itinerary key; no endpoint takes it.
  - `itineraries[].priced_in` (string | null; required): Set only when Google priced this option in another currency than requested: that ISO 4217 code. `price` is then in this currency and `warnings` says so.
  - `itineraries[].carbon_emissions` (object | null; required): Null when Google gives no estimate.
  - `itineraries[].total_duration_minutes` (integer | null; required): Sum of the legs' door-to-door durations, minutes; null when one is unknown.
  - `itineraries[].carry_on_bags_included` (integer | null; required): Carry-on bags included in the fare, as Google states it; null when not stated.
  - `itineraries[].checked_bags_included` (integer | null; required): Checked bags included in the fare, as Google states it; null when not stated.
  - `itineraries[].airline_logo` (string | null; required): Logo URL of the main airline; null when several airlines share the itinerary.
- `elapsed_s` (number; required): Time Google took to answer, seconds.
- `cheapest_price` (number | null; required): Lowest `price` in `itineraries`; null when none is priced.
- `trip_type` (string; required; one of one_way, round_trip, multi_city): `one_way`, `round_trip` or `multi_city`.
- `leg_index` (integer; required): Which leg these options are for: 1 = return or second multi-city leg, and so on.
- `legs_total` (integer; required): Legs in the trip: 1 one-way, 2 round trip, 2-5 multi-city.
- `itinerary_count` (integer; required): Number of entries in `itineraries`.
- `best_count` (integer; required): How many `itineraries` have `group: best`.
- `price_insights` (object | null; optional): Usually null: Google rarely gives insights for a return or later leg. Omitted when `itineraries` is empty; that answer is not billed.
  - `price_insights.lowest_price` (number | null; required): Lowest price Google shows for this search, in `currency`.
  - `price_insights.price_level` (string | null; required; one of low, typical, high): Google's verdict on today's price: `low` (below its typical range), `typical` (inside it) or `high` (above it).
  - `price_insights.typical_price_range` (array of number | null; required; min items 2, max items 2): `[low, high]`: Google's typical price range for this trip.
  - `price_insights.price_history` (array of array of number; required): `[[unix_seconds, price], ...]`: Google's price history for this trip, about 60 days. Empty when Google gives none.
- `airlines_available` (array of object; required): Airlines and alliances Google offers as filters for this search; the codes work in `include_airlines`.
  - `airlines_available[].code` (string; required): IATA airline code, or `STAR_ALLIANCE` / `SKYTEAM` / `ONEWORLD`.
  - `airlines_available[].name` (string | null; required)
  - `airlines_available[].type` (string; required; one of alliance, airline)
- `google_flights_url` (string; required): Google Flights search page for this trip.
- `source` (string; required; one of rpc, html): Always `rpc` for this call.
- `warnings` (array of string; required): Notices about this answer, e.g. that Google priced some options in another currency (see each itinerary's `priced_in`). Empty when none.

Base URL: `https://api.scrapercompany.com`. Auth: send your key in the `x-api-key` header. A failed request (4xx or 5xx) or an empty result costs 0 credits.

- [Full API reference as one Markdown file](https://scrapercompany.com/llms-full.txt)
- [OpenAPI spec](https://scrapercompany.com/openapi.json)
