Skip to content
This page is available in Markdown format. Markdown is recommended for AI consumption. See /overview/index.md for this page, or/llms.txt for the full documentation index.

Wego API

What the Wego API is and how travelers and agents use it to search flights and hotels.

Updated
View as MarkdownView this page as plain text
For humans

Wego is a travel company serving millions of travelers across the Middle East, Asia and beyond. This API exposes the building blocks wego.com itself runs on: resolve travel locations, search flights and hotels, compare fares and room rates, and continue on wego.com to book.

All /v1 operations require an OAuth2 bearer token from the Wego auth server.

Start here

The model

Both verticals run the same shape: create a search, read ranked results, open one result, then continue to wego.com, where the traveler books.

flights: search -> results -> trip -> fare -> booking-link
hotels:  search -> results -> search(hotelId) -> rates -> booking-link

Hotels take one step flights do not. A city search holds only a sample of any one hotel’s rates, so pricing a hotel’s full room list needs a second search created with that hotelId. Reading rates against the city search instead is a 409 rates_require_hotel_search – see the Quickstart for the shape, and Errors for the code.

The API Reference documents the machine contract in full: how async search settles, why ids expire, the fare and rate kinds, error codes, and rate limits.

Research Preview

Everything here is a Research Preview: the API, the wego CLI, the agent skill, and the Wego plugin for ChatGPT and the Wego connector for Claude. We are shipping it early to learn what people and agents actually ask for.

What that means for you:

  • Things change. Endpoints, response shapes, and CLI output can change while we improve them. Read the API Reference rather than caching what you saw last month, and pin nothing you cannot re-check.
  • Coverage is uneven. Results settle asynchronously and some routes, fares, or hotels are missing. An empty result is not proof that nothing exists.
  • No availability promise. There is no SLA yet, and we may pause a surface to fix it.
  • Booking stays on Wego. We return a link where the traveler books. We never take a charge.

Tell us what worked and what did not: wego feedback from the CLI. That feedback is what decides what we build next.

Navigation

Type to search…

↑↓ navigate↵ selectEsc close