---
title: "Flights"
description: "The flight funnel: `createFlightSearch` starts an async search, `getFlightSearchResults` reads ranked snapshots while providers answer, `getFlightTrip` opens one trip with every fare."
---

> Documentation Index
> Fetch the complete documentation index at: https://agents.wego.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Flights

The flight funnel: `createFlightSearch` starts an async search, `getFlightSearchResults` reads ranked snapshots while providers answer, `getFlightTrip` opens one trip with every fare. Fares with `kind: "wego"` continue into `getFareOptions` and `getFareBookingLink`; airline and partner fares carry their own handoff URL instead. Ids expire; a `404` means search again. `getFlightSchedules` sits outside the funnel – a published timetable with no prices and no search to settle.

## Operations

| Verb | Operation | Carries onward |
|---|---|---|
| `POST` | [Create a flight search](/api/flights/create-flight-search) · `/v1/flights/searches` | `searchId` |
| `GET` | [Published timetable for a route](/api/flights/get-flight-schedules) · `/v1/flights/schedules` | `terminal` |
| `GET` | [Read ranked flight results](/api/flights/get-flight-search-results) · `/v1/flights/searches/{searchId}/results` | `tripId` |
| `GET` | [Open one flight trip](/api/flights/get-flight-trip) · `/v1/flights/trips/{tripId}` | `fareId` |
| `GET` | [Read a trip's experience signals](/api/flights/get-trip-experience) · `/v1/flights/trips/{tripId}/experience` | `terminal` |
| `GET` | [List a fare's options](/api/flights/get-fare-options) · `/v1/flights/fares/{fareId}/options` | `fareOptionId` |
| `GET` | [Build a fare's wego.com booking link](/api/flights/get-fare-booking-link) · `/v1/flights/fares/{fareId}/booking-link` | `wego.com URL` |
| `GET` | [Build a durable wego.com search link](/api/flights/get-flight-search-link) · `/v1/flights/search-link` | `wego.com URL` |

Source: https://agents.wego.com/api/flights/index.mdx