# api

## Pages

- [API Reference](https://docs.wego.com/api/index.md) – Every Wego API endpoint, plus the contract rules that govern all of them.
- [Conventions](https://docs.wego.com/api/conventions/index.md) – Query-parameter casing, default sort, and entity-read shapes.
- [Countries](https://docs.wego.com/api/countries/index.md) – Country-keyed reference data an agent can call before any search, and combine.
- [Public holidays for a market](https://docs.wego.com/api/countries/get-country-holidays/index.md) – Public holidays in one Wego market over a date range, for spotting long weekends before searching flights.
- [Visa-free destinations for a passport](https://docs.wego.com/api/countries/get-visa-free-destinations/index.md) – Where a passport can travel without a visa, as one complete list (the API walks the upstream's pages).
- [Errors](https://docs.wego.com/api/errors/index.md) – What the error body carries, and the closed list of codes to branch on.
- [Fares, rates and partners](https://docs.wego.com/api/fares-rates-partners/index.md) – Which flight fares and hotel rates are bookable on wego.com, and which are not.
- [Feedback](https://docs.wego.com/api/feedback/index.md) – Send feedback about the Wego CLI/API experience.
- [Submit feedback](https://docs.wego.com/api/feedback/submit-feedback/index.md) – Records feedback about the Wego CLI/API experience – a rating (1-5), a category, and/or a free-text message.
- [Flights](https://docs.wego.com/api/flights/index.md) – The flight funnel: `createFlightSearch` starts an async search, `getFlightSearchResults` reads ranked snapshots while providers answer, `getFlightTrip` opens one trip with every fare.
- [Create a flight search](https://docs.wego.com/api/flights/create-flight-search/index.md) – Creates a metasearch for the given route/dates/passengers and returns its searchId.
- [Build a fare's wego.com booking link](https://docs.wego.com/api/flights/get-fare-booking-link/index.md) – Builds the wego.com booking deep-link for a chosen Book-on-Wego fare, with one fare option pre-selected PER LEG.
- [List a fare's options](https://docs.wego.com/api/flights/get-fare-options/index.md) – Returns a Book-on-Wego fare's bookable options (price, baggage, refundability, penalties, and the carrier's terms links when it publishes any), ordered by leg then price.
- [Published timetable for a route](https://docs.wego.com/api/flights/get-flight-schedules/index.md) – What actually flies a route – times, duration, aircraft, and the weekdays each flight runs – with no prices and no search to settle.
- [Build a durable wego.com search link](https://docs.wego.com/api/flights/get-flight-search-link/index.md) – Builds a shareable wego.com flight-search URL from the caller's own route, dates, cabin and passengers.
- [Read ranked flight results](https://docs.wego.com/api/flights/get-flight-search-results/index.md) – Ranked trips as lean list cards (default 10, max 50 per page; out-of-range rejected 400), filters + sort applied.
- [Open one flight trip](https://docs.wego.com/api/flights/get-flight-trip/index.md) – Returns one trip's full itinerary and every fare on it (each kind-tagged), for the given tripId within its searchId. searchId is required – it comes from the search/results snapshot the tripId was read from.
- [Read a trip's experience signals](https://docs.wego.com/api/flights/get-trip-experience/index.md) – Per-leg signals for what a journey is like to sit through: overnight, longStopover, earlyDeparture, lateArrival, plus positive-only witnesses for a tight connection, aircraft age and carrier rating.
- [Hotels](https://docs.wego.com/api/hotels/index.md) – The hotel funnel, same shape as flights: `createHotelSearch`, `getHotelSearchResults` for ranked hotels, `getHotel` for static detail, `getHotelRates` for bookable rooms and rates (cheapest first, with board and refundability), `getHotelRateBookingLink` for the wego.com checkout URL.
- [Create a hotel search](https://docs.wego.com/api/hotels/create-hotel-search/index.md) – Creates a Book-on-Wego hotel search (city, single hotel, or geo point) and returns its opaque searchId plus the occupancy priced upstream (resolved child ages, incl. the age-8 fallback when none supplied).
- [Build a hotel booking link](https://docs.wego.com/api/hotels/get-hotel-rate-booking-link/index.md) – Returns the wego.com checkout URL for a chosen rate.
- [List a hotel's rooms & rates](https://docs.wego.com/api/hotels/get-hotel-rates/index.md) – Returns the Book-on-Wego rooms & rates for a hotel (cheapest-first): room name, board, refundability, price, and each rate's composed booking reference id. searchId must name a hotel-scoped search (one created with hotelId); a city or geo search is a 409.
- [Search a hotel's guest reviews](https://docs.wego.com/api/hotels/get-hotel-reviews/index.md) – Guest reviews for a hotel, newest first: rating, pros, cons and the provider.
- [Build a durable wego.com hotel search link](https://docs.wego.com/api/hotels/get-hotel-search-link/index.md) – Builds a shareable wego.com hotel-search URL from the caller's own city, dates and occupancy.
- [Read hotel search results](https://docs.wego.com/api/hotels/get-hotel-search-results/index.md) – Lean list cards; default 10, max 50 per page. searchComplete:true terminal, false advisory; poll snapshotCandidateCount to a steady non-zero. totalCandidates===0 = filters only if totalBeforeFilters>0, else none bookable once complete. ?refundable=true = witnessed.
- [Get hotel detail](https://docs.wego.com/api/hotels/get-hotel/index.md) – Returns static hotel detail (name, stars, address, images, amenities, reviews).
- [How search works](https://docs.wego.com/api/how-search-works/index.md) – Flight and hotel searches are asynchronous; read results until they settle.
- [IDs expire](https://docs.wego.com/api/ids-expire/index.md) – Which ids are snapshots, which are permanent, and what a 404 on each one means.
- [Places](https://docs.wego.com/api/places/index.md) – Turn free text into typed travel locations.
- [Airports and cities near a point](https://docs.wego.com/api/places/get-nearby-places/index.md) – The airports (and optionally cities) closest to a place or a coordinate pair, nearest first – for finding an alternative departure airport serving the same trip.
- [Resolve travel locations](https://docs.wego.com/api/places/get-places/index.md) – Resolves a free-text location query to canonical Wego places (cities, airports, states, districts, hotels) with codes and coordinates, for use in later flight and hotel searches.
- [Rate limits](https://docs.wego.com/api/rate-limits/index.md) – Per-IP and per-user quota, surfaced in RateLimit response headers.
- [User](https://docs.wego.com/api/user/index.md) – The authenticated caller.
- [Get the authenticated user](https://docs.wego.com/api/user/get-current-user/index.md) – Returns the caller's own identity, read from the verified access-token claims.