Hermeseus

Changelog

Notable changes to the travel API, newest first. Each release groups the changes that affect your integration.

How changes are labelled. Added for new endpoints or fields, Changed for behavior that changed, Fixed for corrections, and Breaking for a change that can break an existing integration.

v2.5.0

  • Added. A documentation site at /docs covering flights, hotels, activities, and the common endpoints, with runnable cURL, JavaScript, and Python examples, search, and a light and dark theme.
  • Added. An OpenAPI 3.1 description at /openapi.yaml for import into API clients.
  • Added. Product landing pages at /flights-api, /hotels-api, and /activities-api.

v2.4.0

  • Added. City search at GET /Geo/cities/search, a public type-ahead over a global gazetteer that matches city names and their aliases in many languages.
  • Changed. Responses honor the language you request. Localized-language text is not exposed to API clients; read the corresponding English fields.

v2.3.0

  • Added. The Activity API under /Activity/v2: catalogue (products, products/all, products/by-location), variants, availability by date and timeslot, bookings, vouchers, and configuration.
  • Added. Webhook event polling for ten activity event types under /Activity/v2/webhook-events.
  • Added. A best-selling sort and a per-product sold count, and product-name search in any stored language.
  • Changed. Activity prices are normalized to USD.
  • Fixed. Availability drops dates and timeslots that are already in the past, compared against the activity's local timezone.

v2.2.0

  • Added. The recommended v2 hotel API under /v2/Hotel: availability in city and hotel modes, rate validation, book, order, cancel, booking data, and extend payment deadline.
  • Added. Public hotel place search and lookup under /v2/Hotel/cities/*, including bulk lookup by id.
  • Changed. Hotel prices are normalized to USD, and a validated rate holds for 15 minutes.
  • Changed. Prepayment fields are omitted from v2 hotel responses.
  • Added. The v1 hotel paths remain available for existing integrations. See versioning.

v2.1.0

  • Added. Streaming flight search at AirLowFareSearchIncremental over server-sent events, for a fast first paint.
  • Added. A flight price calendar at AirPriceCalendar, the cheapest fare per day for a route.
  • Added. NumberOfResults to scale the size of the result basket, and AirLowFareSearch2, an alternate result basket.
  • Changed. Search aggregates multiple inventory sources into one response, capped with category diversity (cheapest, fastest, direct, baggage tiers).
  • Fixed. Codeshare and fare-class duplicates collapse to one offer per physical flight.

v2.0.0

  • Breaking. CabinType on the search request is the integer enum: 1 Economy, 2 Premium Economy, 3 Business, 4 Premium Business, 5 First, 6 Premium First. The response CabinClassCode now uses the same enum.
  • Breaking. Gender on AirBook travelers is 0 Male, 1 Female.
  • Changed. Search enforces the requested cabin and drops off-cabin offers.

v1.0.0

  • Added. Session authentication: Authenticate/CreateSession returns a SessionId, and Authenticate/EndSession ends it.
  • Added. The flight flow: search, fare rules, baggage, revalidate, book, issue ticket, cancel, refund, and booking data. Plus AirSearchData to re-read a past search and AirAddBookingNotes.
  • Added. The v1 hotel booking flow.
  • Added. Common endpoints: credit balance, error details, and session history.