---
title: "SearchFlightPrices"
method: GET
path: "/api/aviation/v1/search-flight-prices"
tags: ["AviationService"]
---

# SearchFlightPrices

`GET /api/aviation/v1/search-flight-prices`

## Request

- Base URL: `https://api.worldmonitor.app`
- URL: `https://api.worldmonitor.app/api/aviation/v1/search-flight-prices`
- Auth: one of:
  - API key in header `X-WorldMonitor-Key`
  - API key in header `X-Api-Key`
  - HTTP bearer

Search per-person flight price offers by route, dates and cabin, with indicative-price and provider status. PRO-gated. Requires an active Pro subscription.

## Query parameters

- `origin` string, required
- `destination` string, required
- `departure_date` string, required
- `return_date` string
- `adults` integer
- `cabin` 'CABIN_CLASS_ECONOMY' | 'CABIN_CLASS_PREMIUM_ECONOMY' | 'CABIN_CLASS_BUSINESS' | 'CABIN_CLASS_FIRST'
- `nonstop_only` boolean
- `max_results` integer
- `currency` string
- `market` string
- `jmespath` string

## Response `200`

OK

- WorldmonitorAviationV1SearchFlightPricesResponse: SearchFlightPricesResponse contains flight price offers.
  - `quotes` WorldmonitorAviationV1PriceQuote[]
    - `id` string: Unique quote identifier.
    - `origin` string: Origin airport IATA code.
    - `destination` string: Destination airport IATA code.
    - `departureDate` string: Outbound departure date (ISO 8601).
    - `returnDate` string: Return date (ISO 8601), empty for one-way.
    - `carrier` WorldmonitorAviationV1Carrier: Carrier represents an airline or aircraft operator.
      - `iataCode` string: IATA two-letter airline code (e.g., "TK").
      - `icaoCode` string: ICAO three-letter airline code (e.g., "THY").
      - `name` string: Full airline name (e.g., "Turkish Airlines").
    - `priceAmount` number, double: Total price amount.
    - `currency` string: ISO 4217 currency code (e.g., "EUR", "USD", "TRY").
    - `cabin` 'CABIN_CLASS_UNSPECIFIED' | 'CABIN_CLASS_ECONOMY' | 'CABIN_CLASS_PREMIUM_ECONOMY' | 'CABIN_CLASS_BUSINESS' | 'CABIN_CLASS_FIRST': CabinClass represents the travel class for a flight ticket.
    - `stops` integer: Number of stops (0 = nonstop).
    - `durationMinutes` integer: Total travel duration in minutes.
    - `bookingUrl` string: Booking URL or deep-link (if available).
    - `provider` string: Provider name (e.g., "amadeus", "demo").
    - `isIndicative` boolean: Whether the price is indicative rather than bookable.
    - `observedAt` integer: Warning: Values > 2^53 may lose precision in JavaScript
    - `checkoutRef` string: Reference used during the checkout process (for follow-up actions).
    - `expiresAt` integer: Warning: Values > 2^53 may lose precision in JavaScript
  - `provider` string: Provider name: "travelpayouts_data", "demo", or "none" when no live provider is configured.
  - `isDemoMode` boolean: Whether results are from demo/simulated mode. Requires explicit AVIATION_DEMO_PRICES=1 opt-in on the server. Never true in default self-host / production runs. See issue #3756.
  - `updatedAt` integer: Warning: Values > 2^53 may lose precision in JavaScript
  - `isIndicative` boolean: Whether returned prices are indicative (subject to change).
  - `degraded` boolean: True when the live provider could not satisfy the request — missing credentials, upstream failure, or zero results. Mirrors the searchGoogleFlights pattern so clients can render distinct messages for each error class.
  - `error` string: Discriminator for the degraded state: "" (ok), "missing_credentials" (TRAVELPAYOUTS_API_TOKEN unset), "upstream_error" (provider call threw), "no_results" (provider returned empty for this route).

## Other responses

- `400`: Validation error
- `401`: Missing or invalid API key.
- `403`: Pro subscription required.
- `429`: Rate limit exceeded.
- `503`: Service unavailable. Billing-verification responses include code and X-Billing-Verification; other gateway infrastructure failures use the generic GatewayError shape.
- `default`: Gateway or handler error response.

---

[API](https://skmtc.dev/worldmonitor/apis/worldmonitor-api.md) · [All operations](https://skmtc.dev/worldmonitor/apis/worldmonitor-api/llms.txt) · [OpenAPI document](https://skmtc.dev/worldmonitor/apis/worldmonitor-api/revisions/e3dc8463a5c9?raw)