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

# Get Flight Samples

`GET /flights/samples`

Saved examples with Content-owned allowlist, fixed dates and spend cap.

## Query parameters

- `origin` string, nullable
- `destination` string, nullable

## Response `200`

Successful Response

- FlightDiscoverySamplesResponse
  - `status` 'available' | 'no_sample' | 'temporarily_unavailable', required
  - `origins` string[], required
  - `destinations` string[], required
  - `samples` FlightDiscoverySample[]
    - `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', 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
      - `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

## Other responses

- `422` — Validation Error

## Changes

- **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/ca05fbc4893d?raw)