---
title: "Get Availability"
method: GET
path: "/api/availability"
tags: ["availability"]
---

# Get Availability

`GET /api/availability`

## 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/availability`
- Auth: none declared

Get cached award availability for a route and date.

Returns instant results from the scanner cache (sub-100ms).
If no cached data exists, triggers a background scan and returns
an empty result set with ``scan_triggered=true``.

## Query parameters

- `origin` string, required: IATA origin code
- `destination` string, required: IATA destination code
- `date` string, required: Departure date YYYY-MM-DD
- `cabin` string, nullable: economy, business, first, premium_economy
- `program` string, nullable: Filter by program name

## Response `200`

Successful Response

- AvailabilityResponse: Response for the availability endpoint.
  - `results` AvailabilityResult[], required
    - `origin` string, required
    - `destination` string, required
    - `date` string, required
    - `program` string, required
    - `cabin_class` string, required
    - `available` boolean, required
    - `miles_cost` integer, nullable
    - `taxes_usd` number, nullable
    - `seats_remaining` integer, nullable
    - `source` string
    - `flight_number` string, nullable
    - `departure_time` string, nullable
    - `arrival_time` string, nullable
    - `duration_minutes` integer, nullable
    - `award_type` string, nullable
    - `transfer_partners` string[], nullable
    - `scanned_at` string, nullable
  - `total` integer, required
  - `cached` boolean
  - `scan_triggered` boolean

## 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)