---
title: "Get Flight Pairings"
method: GET
path: "/conv/trips/{trip_id}/flight-pairings/{outbound_observation_id}"
tags: ["conversational"]
---

# Get Flight Pairings

`GET /conv/trips/{trip_id}/flight-pairings/{outbound_observation_id}`

## 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/trips/{trip_id}/flight-pairings/{outbound_observation_id}`
- Auth: HTTP bearer

Round-trip return pairings for an outbound observation (FAC-895).

Safe to poll at 1-2s intervals: the brain reads caches/registry only and
schedules background prefetch on a miss. Returns 409 once no return options
were found or Guide pairing failed.

## Path parameters

- `trip_id` string, required
- `outbound_observation_id` string, required

## Query parameters

- `hotel_proposal_set_id` string, uuid, nullable
- `source_frame_id` string, nullable

## Response `200`

Successful Response

- FlightPairingsResponse: Display-composed round-trip return pairings envelope (FAC-895). ``results`` items are field-compatible with the FE FlightResultOption contract; kept as loose dicts so the pass-through card shape is preserved.
  - `status` 'warming' | 'ready', required
  - `results` object[], nullable
  - `total_available` integer, nullable
  - `timing` object, nullable
  - `market_checked_at` integer, nullable

## Other responses

- `409`: Conflict
- `422`: Validation Error

## Changes

> 82 revisions in range; 1 not diffed.

- **2026-10-13** `25b5027aa68e`: 1 warning, 1 info
  - added the new `no_returns_within_budget` enum value to the `detail/reason` response property for the response status `409`
  - added the new optional `query` request parameter `source_frame_id`
- **2026-09-26** `ff95d5d338e4`: 1 info
  - added the new optional `query` request parameter `hotel_proposal_set_id`
- **2026-09-03** `29c8d734d508`: 1 info
  - added the non-success response with the status `409`

[Operation history](https://skmtc.dev/helloaxel/apis/client-api-gateway/changes/conv/trips/:trip_id/flight-pairings/:outbound_observation_id/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/5d2bae0deed4?raw)