---
title: "Offers"
method: GET
path: "/conv/flight-offers/"
tags: ["conversational", "flight-offers"]
---

# Offers

`GET /conv/flight-offers/`

## Request

- Base URL: `https://api.helloaxel.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.helloaxel.com/conv/flight-offers/`
- Auth: none declared

## Query parameters

- `ids` string[], required

## Response `200`

Successful Response

- GeneratedFlightOffer[]
  - `id` string, required
  - `scope` GeneratedFlightScope, required
    - `origin` string, required
    - `destination` string, required
    - `departure_date` string, date, required
    - `return_date` string, date, nullable
    - `adults` integer
    - `children` integer
    - `cabin` 'economy' | 'premium_economy' | 'business' | 'first'
    - `exclude_basic_economy` boolean
    - `carry_on` boolean
    - `checked_bags` integer
    - `currency` 'USD'
  - `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
  - `version` integer, required
  - `issued_at` string, date-time, required
  - `source` 'axel_generated' | 'live_search'
  - `itinerary` GeneratedFlightItinerary: Schedule facts, separate from the price and its 15-minute clock.
    - `source` 'cirium' | 'saved_search', required
    - `observed_at` string, date-time, required
    - `legs` FlightShareLeg[], required
      - `airline_name` string, nullable
      - `airline_code` string, nullable
      - `origin` string, required
      - `destination` string, required
      - `departure_date` string, required
      - `departure_time` string, nullable
      - `arrival_date` string, nullable
      - `arrival_time` string, nullable
      - `duration_minutes` integer, nullable
      - `stops` integer, required
      - `connection_airports` string[], nullable: Ordered connection airport codes when every segment boundary is known and stays at the same airport. Null when unavailable, incomplete, or requiring an airport change; an empty list means a confirmed nonstop leg.
      - `flight_numbers` string[]
      - `segments` FlightShareSegment[]
        - `origin` string, nullable
        - `destination` string, nullable
        - `departure_date` string, nullable
        - `departure_time` string, nullable
        - `arrival_date` string, nullable
        - `arrival_time` string, nullable
        - `flight_number` string, nullable
        - `duration_minutes` integer, nullable
        - `layover_after_minutes` integer, nullable: Elapsed time until the next segment at the same airport; null when unknown or on the last segment.
    - `projected` boolean
  - `projection` GeneratedFlightProjection: A server-recomputable reference, never a client-supplied price.
    - `scope` GeneratedFlightScope, required
      - `origin` string, required
      - `destination` string, required
      - `departure_date` string, date, required
      - `return_date` string, date, nullable
      - `adults` integer
      - `children` integer
      - `cabin` 'economy' | 'premium_economy' | 'business' | 'first'
      - `exclude_basic_economy` boolean
      - `carry_on` boolean
      - `checked_bags` integer
      - `currency` 'USD'
    - `outbound` string, required
    - `inbound` string, nullable

## Other responses

- `422`: Validation Error

## Changes

> 103 revisions in range; 1 not diffed.

- **2026-10-29** `2078b2931e04`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/helloaxel/apis/client-api-gateway/changes/conv/flight-offers/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/2d3c427963a4?raw)