---
title: "Search Round-Trip Flights"
method: GET
path: "/flights/v2/round-trip"
tags: ["GoogleFlights"]
---

# Search Round-Trip Flights

`GET /flights/v2/round-trip`

## Request

- Base URL: `https://scrappa.co/api`
- URL: `https://scrappa.co/api/flights/v2/round-trip`
- Auth: API key in header `X-API-KEY`

Version 2: fetch outbound starting prices, then pass departure_token to fetch matching returns in a separate paid request.

## Query parameters

- `origin` string, required
- `destination` string, required
- `adults` integer, nullable
- `children` integer, nullable
- `infants_in_seat` integer, nullable
- `infants_on_lap` integer, nullable
- `cabin_class` 'economy' | 'premium_economy' | 'business' | 'first' | 'null', nullable
- `exclude_basic` boolean, nullable
- `max_stops` 'any' | 'nonstop' | 'one_or_fewer' | 'two_or_fewer' | 'null', nullable
- `hl` string, nullable
- `gl` string, nullable
- `currency` string, nullable
- `bags` integer, nullable
- `api_version` integer
- `departure_date` string, date, required
- `return_date` string, date, required
- `sort_by` 'top_flights' | 'cheapest' | 'departure_time' | 'arrival_time' | 'duration' | 'emissions' | 'null', nullable
- `airlines[]` string[]
- `include_baggage` boolean
- `departure_token` string, nullable
- `departure_time_min` integer, nullable
- `departure_time_max` integer, nullable
- `arrival_time_min` integer, nullable
- `arrival_time_max` integer, nullable
- `max_duration_minutes` integer, nullable
- `max_price` integer, nullable

## Response `200`

- object
  - `flights` object[], required
    - `trip_type` string, required
    - `itinerary_complete` boolean, required
    - `price_type` string, required
    - `departure_token` string
    - `outbound_legs` object[], required
    - `return_legs` object[], required
    - `outbound_stops` integer, required
    - `return_stops` integer, nullable, required
    - `stops` integer, nullable, required
    - `outbound_duration_minutes` integer, required
    - `return_duration_minutes` integer, nullable, required
    - `booking_token` string, nullable, required
    - `price` number, required
    - `currency` string, required
    - `total_duration_minutes` integer, nullable, required
    - `legs` object[], required
      - `departure_airport` string, nullable, required
      - `arrival_airport` string, nullable, required
      - `departure_time` string, nullable, required
      - `arrival_time` string, nullable, required
      - `duration_minutes` integer, required
      - `airline` string, nullable, required
      - `airline_name` string, nullable, required
      - `flight_number` string, nullable, required
      - `stops` integer, nullable, required
      - `aircraft` string, nullable, required
  - `search_metadata` object, required
    - `api_version` integer, required
    - `stage` string, required
    - `origin` string, required
    - `destination` string, required
    - `departure_date` string, required
    - `return_date` string, required
    - `passengers` object, required
      - `adults` integer, required
      - `children` integer, required
      - `infants_in_seat` integer, required
      - `infants_on_lap` integer, required
    - `cabin_class` string, required
    - `max_stops` string, required
    - `sort_by` string, required
    - `airlines` unknown[], nullable, required
      - unknown
    - `response_time_ms` integer, required

## Other responses

- `401`: Unauthorized - API key is missing or invalid
- `422`: Validation error

---

[API](https://skmtc.dev/scrappa/apis/scrappa-api-documentation.md) · [All operations](https://skmtc.dev/scrappa/apis/scrappa-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/scrappa/apis/scrappa-api-documentation/revisions/1e1aa78ff103?raw)