---
title: "Engage"
method: POST
path: "/conv/flight-offers/{offer_id}/engage"
tags: ["conversational", "flight-offers"]
---

# Engage

`POST /conv/flight-offers/{offer_id}/engage`

## 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/{offer_id}/engage`
- Auth: none declared. Required headers: `X-Axel-Quote-Session`

## Path parameters

- `offer_id` string, required

## Headers

- `X-Axel-Quote-Session` string, uuid, required
- `CF-Connecting-IP` string, nullable
- `X-Axel-Flight-Source` string, nullable
- `X-Axel-Flight-Source-Signature` string, nullable

## Request body

- GeneratedFlightEngagement
  - `version` integer, required
  - `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

## Response `200`

Successful Response

- GeneratedFlightEngagementResult
  - `url` 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
  - `refreshed` boolean, required

## 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/:offer_id/engage/post.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)