More

Changelog

Every release of the 1fly API, newest first, with each change marked patch, minor or major.

Releases follow semantic versioning: patch releases fix behaviour without changing the contract, minor releases add things you can ignore until you need them, and major releases contain breaking changes. While the version is 0.x, a minor release may still contain breaking changes; each one is marked Breaking below so you never have to guess. The HTTP route prefix /v1 is independent of the release number.

v0.1.2 — 2026-11-22#

Patch release: search any airport in the world.

  • Patch · fixEvery airport. GET /v1/public/airports and the find_airports tool search about 4,000 airports by code, city, airport name or country, in Uzbek, Russian or English (before: 40 popular airports). Cities with several airports are one place with their city code (PAR, LON, MOW, NYC, ...).
  • Patch · fixAirport names in search results. Search views include places: every airport in the query and the offers, named in the requested language.
  • Patch · fixFewer failed bookings on Don. Sellers that cannot book can be left out of search, and a flight sold by several sellers is shown once, at the cheapest price.

v0.1.1 — 2026-11-22#

Patch release of the traveller site and the public search API.

  • Patch · fixPrices for nearby dates. On Don, the days around a search are priced in the background. priceCalendar days now carry a state (priced, none, pending, unknown); keep polling while any day is pending.
  • Patch · fixAirline logos and flight details. Result cards show each airline's logo, clearer baggage, refund and seat icons, and a "Flight details" panel with every flight and layover.
  • Patch · fixAirline names on segments. Search segments include carrierName when the supplier names the airline.

v0.1.0 — 2026-11-22#

Agents platform: AI agents can search, book, pay in test mode, issue and void through MCP and UTCP.

  • Minor · additiveReal flights from Don. Search and booking run on the Don supplier network (b2b.onlinetrip.uz). Production uses Don's test suppliers until live booking is switched on, so tickets are test tickets.
  • Minor · additiveAgency search. GET /v1/airports, POST /v1/searches (waits on the server up to waitSeconds), GET /v1/searches/{id}, GET /v1/offers/{id}, /fare-options and /rules, with the new scope search:read (implied by orders:write).
  • Minor · additiveBook from an offer. POST /v1/orders accepts offerId + fareBrand; the server rebuilds flights and price. Without idempotencyKey one is derived from the body.
  • Minor · additiveManual issue and void. issue: "manual" orders wait in paid_hold for POST /v1/orders/{id}/issue; POST /v1/orders/{id}/void voids tickets within 24 hours and refunds (new status voided). New scope orders:issue.
  • Minor · additiveTest payments by API. POST /v1/orders/{id}/simulate-payment.
  • Minor · additiveMCP. Eight new tools (find_airports, search_flights, get_search_results, get_offer, get_fare_options, get_fare_rules, issue_order, void_order), the book_and_issue prompt and an updated booking-flow resource. See MCP.
  • Minor · additiveUTCP. GET /utcp publishes the same tools as a UTCP manual; calls are logged with channel: utcp. See UTCP.

v0.0.3 — 2026-11-21#

Hosting release. The API is unchanged and stays at v0.0.1.

  • Patch · fixHosted at 1fly.uz. The traveller site, dashboard, API, MCP server and these docs now run in production at 1fly.uz, app.1fly.uz, api.1fly.uz, mcp.1fly.uz and docs.1fly.uz, all over HTTPS.

v0.0.2 — 2026-11-17#

Patch release of the traveller site. The API is unchanged and stays at v0.0.1.

  • Patch · fixTraveller site search bar. On wide screens every search field now has the same height and lines up with the Search button; the swap control uses a proper two-arrow icon (left/right side by side, up/down when the fields stack on phones).

v0.0.1 — 2026-11-17#

First public release of the 1fly API.

  • Minor · additiveOrders. POST /v1/orders creates an order and starts booking; GET /v1/orders, GET /v1/orders/{id}, price decisions and cancellation. Idempotent on idempotencyKey. See Orders & booking lifecycle.
  • Minor · additiveTimeline (chronology). GET /v1/orders/{id}/timeline returns every attempt of every booking step, with error codes, categories and hints, plus a per-step summary. See Chronology.
  • Minor · additiveAnalytics. GET /v1/analytics/overview, funnel, steps, errors and timeseries for your account.
  • Minor · additiveAPI keys. Test keys (1fly_test_…) with four scopes, optional expiry and instant revocation, managed in the dashboard. See Authentication.
  • Minor · additiveRequest logs. GET /v1/logs and GET /v1/logs/{id}: every request made with your keys, through MCP or from the dashboard, with redacted bodies. See Request logs.
  • Minor · additiveMCP server. Nine tools for AI agents at http://localhost:4100/mcp (Streamable HTTP) or over stdio. See MCP.
  • Minor · additivePayment webhooks. POST /v1/webhooks/mockpay, deduplicated by provider event id; Click, Payme and Stripe follow the same contract. See Webhooks & payments.
  • Minor · additivePublic booking. /v1/public/*: airport search in Uzbek, Russian and English, flight search with results per supplier, fare options, guest booking with an access token, test payments and trip lookup. Used by the traveller site.
  • Minor · additivePlans and limits. Free, Basic and Pro plans with monthly order quotas and per-minute request limits. See Rate limits & plans.
API version v0.0.1 · Spec generated from source on 2026-11-22Changelog · Prices in so‘m (UZS)