---
title: "Get Flight Samples"
method: GET
path: "/flights/samples"
tags: ["flights"]
---

# Get Flight Samples

`GET /flights/samples`

Saved examples; read_only or matching filters prohibit supplier refresh.

## Query parameters

- `origin` string, nullable
- `destination` string, nullable
- `departure_start` string, date, nullable
- `departure_end` string, date, nullable
- `return_date` string, date, nullable
- `min_nights` integer, nullable
- `max_nights` integer, nullable
- `adults` integer, nullable
- `children` integer, nullable
- `max_stops` integer, nullable
- `sample_limit` integer
- `read_only` boolean
- `include_complete` boolean
- `overview` boolean
- `evidence_dates` string, nullable

## Response `200`

Successful Response

- FlightDiscoverySamplesResponse
  - `status` 'available' | 'no_sample' | 'temporarily_unavailable', required
  - `origins` string[], required
  - `destinations` string[], required
  - `samples` FlightDiscoverySample[]
    - `evidence_stage` 'exact_starting' | 'complete_itinerary' | 'one_way'
    - `origin` string, required
    - `destination` string, required
    - `departure_date` string, date, required
    - `return_date` string, date, nullable, required
    - `passengers` PassengerCount, required — Passenger breakdown for offers/searches. Simple counts by type.
      - `adults` integer
      - `children` integer
      - `infants_in_seat` integer
      - `infants_on_lap` integer
    - `requested_cabin` 'economy'
    - `observed_at` string, date-time, required
    - `source` 'google_flights'
    - `supplier_response_created_at` string, date-time, nullable
    - `price_basis` 'one_way_total' | 'round_trip_starting_total' | 'round_trip_total', required
    - `outbound_only_display` boolean, required
    - `options` FlightSampleOption[], required
      - `carrier` string, required
      - `carrier_code` string, required
      - `flight_numbers` string[], required
      - `departure_time` string, required
      - `arrival_time` string, required
      - `duration_minutes` integer, nullable
      - `stops` integer, required
      - `stop_airports` string[], required
      - `return_journey` FlightSampleJourney
        - `carrier` string, required
        - `carrier_code` string, required
        - `flight_numbers` string[], required
        - `departure_time` string, required
        - `arrival_time` string, required
        - `duration_minutes` integer, nullable
        - `stops` integer, required
        - `stop_airports` string[], required
      - `price` Money, required — Immutable money value stored as integer minor units. Amount is always stored in the smallest currency unit (cents, yen, pesos, etc). This avoids floating-point precision issues and matches payment processor standards. Examples: $19.99 USD -> Money(amount=1999, currency="USD") ¥1000 JPY -> Money(amount=1000, currency="JPY") $1000.00 CLP -> Money(amount=1000, currency="CLP") Serializes to {"amount": 1999, "currency": "USD"}. IMPORTANT: Use Money.from_decimal() for user-facing amounts like "$19.99". The constructor expects integer minor units (cents).
        - `amount` integer, required
        - `currency` string, required
      - `axel_price_flight_only` Money, required — Immutable money value stored as integer minor units. Amount is always stored in the smallest currency unit (cents, yen, pesos, etc). This avoids floating-point precision issues and matches payment processor standards. Examples: $19.99 USD -> Money(amount=1999, currency="USD") ¥1000 JPY -> Money(amount=1000, currency="JPY") $1000.00 CLP -> Money(amount=1000, currency="CLP") Serializes to {"amount": 1999, "currency": "USD"}. IMPORTANT: Use Money.from_decimal() for user-facing amounts like "$19.99". The constructor expects integer minor units (cents).
        - `amount` integer, required
        - `currency` string, required
      - `axel_member_price` Money — Immutable money value stored as integer minor units. Amount is always stored in the smallest currency unit (cents, yen, pesos, etc). This avoids floating-point precision issues and matches payment processor standards. Examples: $19.99 USD -> Money(amount=1999, currency="USD") ¥1000 JPY -> Money(amount=1000, currency="JPY") $1000.00 CLP -> Money(amount=1000, currency="CLP") Serializes to {"amount": 1999, "currency": "USD"}. IMPORTANT: Use Money.from_decimal() for user-facing amounts like "$19.99". The constructor expects integer minor units (cents).
        - `amount` integer, required
        - `currency` string, required
    - `history` FlightSampleHistory
      - `source` 'google_flights'
      - `currency` 'USD'
      - `passengers` 1
      - `price_history` FlightSampleHistoryPoint[], required
        - `date` string, date, required
        - `price_cents` integer, required
      - `typical_low_cents` integer, nullable
      - `typical_high_cents` integer, nullable
  - `discovery_fares` FlightDiscoveryFare[]
    - `evidence_stage` 'market_lead'
    - `source` 'google_flights_deals'
    - `origin` string, required
    - `destination` string, required
    - `departure_date` string, date, required
    - `return_date` string, date, required
    - `requested_passengers` PassengerCount, required — Passenger breakdown for offers/searches. Simple counts by type.
      - `adults` integer
      - `children` integer
      - `infants_in_seat` integer
      - `infants_on_lap` integer
    - `priced_passengers` PassengerCount — Passenger breakdown for offers/searches. Simple counts by type.
      - `adults` integer
      - `children` integer
      - `infants_in_seat` integer
      - `infants_on_lap` integer
    - `price` Money — Immutable money value stored as integer minor units. Amount is always stored in the smallest currency unit (cents, yen, pesos, etc). This avoids floating-point precision issues and matches payment processor standards. Examples: $19.99 USD -> Money(amount=1999, currency="USD") ¥1000 JPY -> Money(amount=1000, currency="JPY") $1000.00 CLP -> Money(amount=1000, currency="CLP") Serializes to {"amount": 1999, "currency": "USD"}. IMPORTANT: Use Money.from_decimal() for user-facing amounts like "$19.99". The constructor expects integer minor units (cents).
      - `amount` integer, required
      - `currency` string, required
    - `axel_price_flight_only` Money — Immutable money value stored as integer minor units. Amount is always stored in the smallest currency unit (cents, yen, pesos, etc). This avoids floating-point precision issues and matches payment processor standards. Examples: $19.99 USD -> Money(amount=1999, currency="USD") ¥1000 JPY -> Money(amount=1000, currency="JPY") $1000.00 CLP -> Money(amount=1000, currency="CLP") Serializes to {"amount": 1999, "currency": "USD"}. IMPORTANT: Use Money.from_decimal() for user-facing amounts like "$19.99". The constructor expects integer minor units (cents).
      - `amount` integer, required
      - `currency` string, required
    - `axel_member_price` Money — Immutable money value stored as integer minor units. Amount is always stored in the smallest currency unit (cents, yen, pesos, etc). This avoids floating-point precision issues and matches payment processor standards. Examples: $19.99 USD -> Money(amount=1999, currency="USD") ¥1000 JPY -> Money(amount=1000, currency="JPY") $1000.00 CLP -> Money(amount=1000, currency="CLP") Serializes to {"amount": 1999, "currency": "USD"}. IMPORTANT: Use Money.from_decimal() for user-facing amounts like "$19.99". The constructor expects integer minor units (cents).
      - `amount` integer, required
      - `currency` string, required
    - `price_basis` 'round_trip_total' | 'round_trip_per_person' | 'unknown'
    - `price_basis_verified` boolean
    - `cabin` 'economy'
    - `reported_stops` integer, nullable
    - `stops_basis` 'outbound' | 'round_trip' | 'unknown'
    - `observed_at` string, date-time, required
    - `supplier_response_created_at` string, date-time, nullable

## Other responses

- `422` — Validation Error

## Changes

> 19 revisions in range; 1 not diffed.

- **2026-09-18** `a3e985bf842c` — 2 info
  - added the new optional `query` request parameter `evidence_dates`
  - added the new optional `query` request parameter `overview`
- **2026-09-17** `74c5393c2f89` — 1 warning, 14 info
  - added the new `round_trip_total` enum value to the `samples/items/price_basis` response property for the response status `200`
  - added the new optional `query` request parameter `adults`
  - added the new optional `query` request parameter `children`
  - added the new optional `query` request parameter `departure_end`
  - …11 more
- **2026-09-16** `ca05fbc4893d` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/helloaxel/apis/client-api-gateway/changes/flights/samples/get.md)

---

[API](https://skmtc.dev/helloaxel/apis/client-api-gateway.md) · [All operations](https://skmtc.dev/helloaxel/apis/client-api-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/helloaxel/apis/client-api-gateway/revisions/201bba08e85c?raw)