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/airportsand thefind_airportstool 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.
priceCalendardays now carry astate(priced,none,pending,unknown); keep polling while any day ispending. - 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
carrierNamewhen 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 towaitSeconds),GET /v1/searches/{id},GET /v1/offers/{id},/fare-optionsand/rules, with the new scopesearch:read(implied byorders:write). - Minor · additiveBook from an offer.
POST /v1/ordersacceptsofferId+fareBrand; the server rebuilds flights and price. WithoutidempotencyKeyone is derived from the body. - Minor · additiveManual issue and void.
issue: "manual"orders wait inpaid_holdforPOST /v1/orders/{id}/issue;POST /v1/orders/{id}/voidvoids tickets within 24 hours and refunds (new statusvoided). New scopeorders: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_issueprompt and an updated booking-flow resource. See MCP. - Minor · additiveUTCP.
GET /utcppublishes the same tools as a UTCP manual; calls are logged withchannel: 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.uzanddocs.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/orderscreates an order and starts booking;GET /v1/orders,GET /v1/orders/{id}, price decisions and cancellation. Idempotent onidempotencyKey. See Orders & booking lifecycle. - Minor · additiveTimeline (chronology).
GET /v1/orders/{id}/timelinereturns 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,errorsandtimeseriesfor 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/logsandGET /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.