---
title: "Upgrade Options"
method: POST
path: "/api/flights/upgrade-options"
tags: ["upgrades"]
---

# Upgrade Options

`POST /api/flights/upgrade-options`

## Request

- Base URL: `https://api.pointifytravels.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.pointifytravels.com/api/flights/upgrade-options`
- Auth: none declared

## Request body

- UpgradeOptionsRequest
  - `origin` string, required
  - `destination` string, required
  - `departure_date` string, required
  - `return_date` string, nullable
  - `passengers` integer
  - `base_cabin` 'economy' | 'premium_economy' | 'business' | 'first'
  - `base_price_cash` number, nullable
  - `base_offer_id` string, nullable

## Response `200`

Successful Response

- UpgradeOptionsResponse
  - `origin` string, required
  - `destination` string, required
  - `baseCabin` 'economy' | 'premium_economy' | 'business' | 'first', required
  - `options` UpgradeOption[]
    - `cabin` 'economy' | 'premium_economy' | 'business' | 'first', required
    - `cabinMarketingName` string, nullable
    - `priceCash` number, nullable
    - `upgradeCostCash` number, nullable
    - `pricePoints` integer, nullable
    - `pointsProgramName` string, nullable
    - `cppValue` number, nullable
    - `currency` string
    - `seatsRemaining` integer, nullable
    - `bookable` boolean
    - `bookingOfferId` string, nullable
    - `likelihood` UpgradeLikelihood: Estimated openness of a target cabin, from real signals only.
      - `band` string, required
      - `score` number, nullable
      - `basis` string[]
      - `estimate` boolean
  - `seatUpgrades` SeatUpgrade[]
    - `label` string, required
    - `price` number, required
    - `currency` string
    - `serviceId` string, nullable
  - `source` string

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/pointifytravels/apis/pointify-deal-engine.md) · [All operations](https://skmtc.dev/pointifytravels/apis/pointify-deal-engine/llms.txt) · [OpenAPI document](https://skmtc.dev/pointifytravels/apis/pointify-deal-engine/revisions/4350142a4216?raw)