How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Wego API

The public Wego API: resolve travel locations, create asynchronous flight and hotel searches, read ranked results, open one trip or hotel, list fares and room rates, and build wego.com booking or share links. Reference lookups (public holidays, visa-free destinations, flight schedules, nearby airports) need no search at all. OAuth2 bearer, RFC 9457 problem bodies, RateLimit headers. Research Preview.

This API exposes 22 operations across 22 paths, organized into 7 resource areas, and defines 1 schema. It is described by OpenAPI 3.1.0, at version 0.19.0.

Requests are made against a single base URL, https://api.wego.com.

22 operations 22 paths 1 schemas 19 GET3 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
0.19.0
Base URL
https://api.wego.com
Authentication
HTTP Bearer, OAuth 2.0
Resource Areas
7

Authentication & Security 2

Wego API declares 2 security schemes for authenticating requests. It accepts HTTP bearer tokens (JWT) (bearerAuth). It supports OAuth 2.0 (oauth2) using the authorizationCode flow, exposing 3 scopes. By default, every request must be authenticated.

  • bearerAuth — Wego auth server access token, sent as Authorization: Bearer (RFC 6750).
  • oauth2 — OAuth2 authorization-code flow (PKCE supported) against the Wego auth server.

Paths & Operations 22

Across 22 paths, the API surfaces 22 operations — 19 GET, 3 POST. They span 7 resource areas: Operations, User, Feedback, Places, Countries, Flights, Hotels. Each is listed below with its method, path, parameters, and response codes.

Operations 1
GET
/health
Health check
getHealth → 200
User 1

The authenticated caller. getCurrentUser returns the identity behind the bearer token (the CLI's wego whoami).

GET
/v1/user
Get the authenticated user
getCurrentUser → 200401429
Feedback 1

Send feedback about the Wego CLI/API experience. submitFeedback records an optional category plus at least one of a rating (1-5) or a free-text message (the CLI's wego feedback);…

POST
/v1/feedback
Submit feedback
submitFeedback body → 202400401429
Places 2

Turn free text into typed travel locations. getPlaces resolves a city, airport, district or hotel name to results carrying the codes the flight and hotel searches take as input. g…

GET
/v1/places/nearby
Airports and cities near a point
getNearbyPlaces 6 params → 200400401429502503
GET
/v1/places
Resolve travel locations
getPlaces 5 params → 200400401429502503
Countries 2

Country-keyed reference data an agent can call before any search, and combine. getCountryHolidays returns a market's public holidays for spotting long weekends; getVisaFreeDestina…

GET
/v1/countries/{countryCode}/holidays
Public holidays for a market
getCountryHolidays 4 params → 200400401429502503
GET
/v1/countries/{countryCode}/visa-free-destinations
Visa-free destinations for a passport
getVisaFreeDestinations 4 params → 200400401429502503
Flights 8

The flight funnel: createFlightSearch starts an async search, getFlightSearchResults reads ranked snapshots while providers answer, getFlightTrip opens one trip with every fare. F…

POST
/v1/flights/searches
Create a flight search
createFlightSearch body → 201400401429502503
GET
/v1/flights/schedules
Published timetable for a route
getFlightSchedules 7 params → 200400401429502503
GET
/v1/flights/searches/{searchId}/results
Read ranked flight results
getFlightSearchResults 33 params → 200400401404429502503
GET
/v1/flights/trips/{tripId}
Open one flight trip
getFlightTrip 5 params → 200400401404429502503
GET
/v1/flights/trips/{tripId}/experience
Read a trip's experience signals
getTripExperience 2 params → 200400401404429502503
GET
/v1/flights/fares/{fareId}/options
List a fare's options
getFareOptions 3 params → 200400401404429502503
GET
/v1/flights/fares/{fareId}/booking-link
Build a fare's wego.com booking link
getFareBookingLink 17 params → 200400401429
GET
/v1/flights/search-link
Build a durable wego.com search link
getFlightSearchLink 13 params → 200400401429
Hotels 7

The hotel funnel, same shape as flights: createHotelSearch, getHotelSearchResults for ranked hotels, getHotel for static detail, getHotelRates for bookable rooms and rates (cheape…

POST
/v1/hotels/searches
Create a hotel search
createHotelSearch body → 201400401404429502503
GET
/v1/hotels/searches/{searchId}/results
Read hotel search results
getHotelSearchResults 22 params → 200400401404429502503
GET
/v1/hotels/{hotelId}/rates/{rateId}/booking-link
Build a hotel booking link
getHotelRateBookingLink 7 params → 200400401429
GET
/v1/hotels/search-link
Build a durable wego.com hotel search link
getHotelSearchLink 10 params → 200400401429
GET
/v1/hotels/{hotelId}/rates
List a hotel's rooms & rates
getHotelRates 4 params → 200400401404409429502503
GET
/v1/hotels/{hotelId}/reviews
Search a hotel's guest reviews
getHotelReviews 8 params → 200400401404429502503
GET
/v1/hotels/{hotelId}
Get hotel detail
getHotel 3 params → 200400401404429502503

Schemas 1

The contract defines 1 schema that model the data the API accepts and returns. The most detailed is Problem (7 properties). Each schema is shown below with its type and property counts.

Problem
object
RFC 9457 Problem Details, served as application/problem+json.
7 properties 6 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

wego-api-openapi.json Raw ↑
Where this information came from

This is an independent, third-party profile of Wego API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.