API reference
Public booking
Traveller site: search, fares, guest booking and payment.
Find airports#
By IATA code, city or airport name in Uzbek, Russian or English. Empty q returns popular airports. Max 8 results.
Parameters
Query parameters
| Name | Type | Description |
|---|---|---|
q | string | max length: 60 |
lang | string | one of: "uz", "ru", "en"default: "en" |
Code samples
curl 'https://api.1fly.uz/v1/public/airports'const res = await fetch('https://api.1fly.uz/v1/public/airports');
const data = await res.json();
if (!res.ok) throw new Error(`${data.error.code}: ${data.error.message} (request ${data.error.requestId})`);import requests
resp = requests.get(
"https://api.1fly.uz/v1/public/airports",
timeout=30,
)
data = resp.json()
if not resp.ok:
raise RuntimeError(f"{data['error']['code']}: {data['error']['message']}")Responses
200Airports.
{
"airports": [
{
"code": "TAS",
"city": "Toshkent",
"name": "Toshkent xalqaro aeroporti",
"country": "O‘zbekiston",
"countryCode": "UZ"
}
]
}500Unexpected error on our side; quote the requestId.
| Field | Type | Description |
|---|---|---|
errorrequired | object | |
code (in error)required | string | Stable machine-readable code, e.g. VALIDATION_FAILED. |
message (in error)required | string | Human-readable explanation. |
requestId (in error)required | string | Quote this to support; also in the x-request-id header and the request log. |
issues (in error) | array<object> | Present for VALIDATION_FAILED: one entry per problem. |
path (in error.issues) | string | Example: passengers.0.lastName |
code (in error.issues) | string | |
message (in error.issues) | string |
{
"error": {
"code": "string",
"message": "string",
"requestId": "5b0c9a7e-2d1f-4e3a-9b8c-7d6e5f4a3b2c",
"issues": [
{
"path": "passengers.0.lastName",
"code": "string",
"message": "string"
}
]
}
}Start a flight search#
Returns a signed search id at once; poll GET /v1/public/searches/{id} until status is complete (usually 2–5 s). Results are valid for 10 minutes.
Request body application/json required
| Field | Type | Description |
|---|---|---|
fromrequired | string | pattern: ^[A-Z]{3}$ |
torequired | string | pattern: ^[A-Z]{3}$ |
departDaterequired | string | pattern: ^\d{4}-\d{2}-\d{2}$ |
returnDate | string | null | |
adultsrequired | integer | range: 1–9 |
children | integer | range: 0–8default: 0 |
infants | integer | range: 0–9default: 0 |
cabin | string | one of: "economy", "business"default: "economy" |
{
"from": "TAS",
"to": "IST",
"departDate": "2027-03-12",
"returnDate": "2027-03-19",
"adults": 1,
"children": 0,
"infants": 0,
"cabin": "economy"
}Code samples
curl -X POST 'https://api.1fly.uz/v1/public/searches' \
-H 'Content-Type: application/json' \
-d '{
"from": "TAS",
"to": "IST",
"departDate": "2027-03-12",
"returnDate": "2027-03-19",
"adults": 1,
"children": 0,
"infants": 0,
"cabin": "economy"
}'const res = await fetch('https://api.1fly.uz/v1/public/searches', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
},
body: JSON.stringify({
"from": "TAS",
"to": "IST",
"departDate": "2027-03-12",
"returnDate": "2027-03-19",
"adults": 1,
"children": 0,
"infants": 0,
"cabin": "economy"
}),
});
const data = await res.json();
if (!res.ok) throw new Error(`${data.error.code}: ${data.error.message} (request ${data.error.requestId})`);import requests
resp = requests.post(
"https://api.1fly.uz/v1/public/searches",
json={
"from": "TAS",
"to": "IST",
"departDate": "2027-03-12",
"returnDate": "2027-03-19",
"adults": 1,
"children": 0,
"infants": 0,
"cabin": "economy",
},
timeout=30,
)
data = resp.json()
if not resp.ok:
raise RuntimeError(f"{data['error']['code']}: {data['error']['message']}")Responses
201Search started.
{
"searchId": "eyJx…",
"expiresAt": "2026-11-17T10:10:00.000Z"
}500Unexpected error on our side; quote the requestId.
| Field | Type | Description |
|---|---|---|
errorrequired | object | |
code (in error)required | string | Stable machine-readable code, e.g. VALIDATION_FAILED. |
message (in error)required | string | Human-readable explanation. |
requestId (in error)required | string | Quote this to support; also in the x-request-id header and the request log. |
issues (in error) | array<object> | Present for VALIDATION_FAILED: one entry per problem. |
path (in error.issues) | string | Example: passengers.0.lastName |
code (in error.issues) | string | |
message (in error.issues) | string |
{
"error": {
"code": "string",
"message": "string",
"requestId": "5b0c9a7e-2d1f-4e3a-9b8c-7d6e5f4a3b2c",
"issues": [
{
"path": "passengers.0.lastName",
"code": "string",
"message": "string"
}
]
}
}Get search results#
Offers arrive supplier by supplier while status is running; each offer has its total, per-adult price, legs and best/cheapest/fastest tags. Includes a ±3-day price calendar.
Parameters
Path parameters
| Name | Type | Description |
|---|---|---|
idrequired | string | Signed search id. pattern: ^[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+$ |
Query parameters
| Name | Type | Description |
|---|---|---|
lang | string | one of: "uz", "ru", "en"default: "en" |
Code samples
curl 'https://api.1fly.uz/v1/public/searches/A.B'const res = await fetch('https://api.1fly.uz/v1/public/searches/A.B');
const data = await res.json();
if (!res.ok) throw new Error(`${data.error.code}: ${data.error.message} (request ${data.error.requestId})`);import requests
resp = requests.get(
"https://api.1fly.uz/v1/public/searches/A.B",
timeout=30,
)
data = resp.json()
if not resp.ok:
raise RuntimeError(f"{data['error']['code']}: {data['error']['message']}")Responses
200Results.
{
"status": "running",
"suppliersDone": 4,
"suppliersTotal": 7,
"offers": []
}500Unexpected error on our side; quote the requestId.
| Field | Type | Description |
|---|---|---|
errorrequired | object | |
code (in error)required | string | Stable machine-readable code, e.g. VALIDATION_FAILED. |
message (in error)required | string | Human-readable explanation. |
requestId (in error)required | string | Quote this to support; also in the x-request-id header and the request log. |
issues (in error) | array<object> | Present for VALIDATION_FAILED: one entry per problem. |
path (in error.issues) | string | Example: passengers.0.lastName |
code (in error.issues) | string | |
message (in error.issues) | string |
{
"error": {
"code": "string",
"message": "string",
"requestId": "5b0c9a7e-2d1f-4e3a-9b8c-7d6e5f4a3b2c",
"issues": [
{
"path": "passengers.0.lastName",
"code": "string",
"message": "string"
}
]
}
}Get fare options#
Light, Standard and Flex with baggage, refund and change rules and prices for all passengers. Offers expire 30 minutes after the search.
Parameters
Path parameters
| Name | Type | Description |
|---|---|---|
idrequired | string | Signed offer id from search results. pattern: ^[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+$ |
Code samples
curl 'https://api.1fly.uz/v1/public/offers/A.B'const res = await fetch('https://api.1fly.uz/v1/public/offers/A.B');
const data = await res.json();
if (!res.ok) throw new Error(`${data.error.code}: ${data.error.message} (request ${data.error.requestId})`);import requests
resp = requests.get(
"https://api.1fly.uz/v1/public/offers/A.B",
timeout=30,
)
data = resp.json()
if not resp.ok:
raise RuntimeError(f"{data['error']['code']}: {data['error']['message']}")Responses
200Offer.
{}404OFFER_EXPIRED: search again.
| Field | Type | Description |
|---|---|---|
errorrequired | object | |
code (in error)required | string | Stable machine-readable code, e.g. VALIDATION_FAILED. |
message (in error)required | string | Human-readable explanation. |
requestId (in error)required | string | Quote this to support; also in the x-request-id header and the request log. |
issues (in error) | array<object> | Present for VALIDATION_FAILED: one entry per problem. |
path (in error.issues) | string | Example: passengers.0.lastName |
code (in error.issues) | string | |
message (in error.issues) | string |
{
"error": {
"code": "string",
"message": "string",
"requestId": "5b0c9a7e-2d1f-4e3a-9b8c-7d6e5f4a3b2c",
"issues": [
{
"path": "passengers.0.lastName",
"code": "string",
"message": "string"
}
]
}
}500Unexpected error on our side; quote the requestId.
| Field | Type | Description |
|---|---|---|
errorrequired | object | |
code (in error)required | string | Stable machine-readable code, e.g. VALIDATION_FAILED. |
message (in error)required | string | Human-readable explanation. |
requestId (in error)required | string | Quote this to support; also in the x-request-id header and the request log. |
issues (in error) | array<object> | Present for VALIDATION_FAILED: one entry per problem. |
path (in error.issues) | string | Example: passengers.0.lastName |
code (in error.issues) | string | |
message (in error.issues) | string |
{
"error": {
"code": "string",
"message": "string",
"requestId": "5b0c9a7e-2d1f-4e3a-9b8c-7d6e5f4a3b2c",
"issues": [
{
"path": "passengers.0.lastName",
"code": "string",
"message": "string"
}
]
}
}Book as a guest#
The price comes from the offer on the server. Every problem (fields, passenger mix, ages, passport validity) is returned at once. The access token is returned once; keep it to follow the booking.
Request body application/json required
| Field | Type | Description |
|---|---|---|
offerIdrequired | string | length: 10–2000 |
brandrequired | string | one of: "Light", "Standard", "Flex" |
passengersrequired | array<object> | items: 1–9 |
type (in passengers)required | string | one of: "ADT", "CHD", "INF" |
firstName (in passengers)required | string | pattern: ^[A-Za-z]+(?:[ '-][A-Za-z]+)*$length: 1–60 |
lastName (in passengers)required | string | pattern: ^[A-Za-z]+(?:[ '-][A-Za-z]+)*$length: 1–60 |
birthDate (in passengers)required | string | pattern: ^\d{4}-\d{2}-\d{2}$ |
gender (in passengers)required | string | one of: "M", "F" |
citizenship (in passengers)required | string | pattern: ^[A-Z]{2}$ |
documentNumber (in passengers)required | string | pattern: ^[A-Z0-9]{5,20}$ |
documentExpiry (in passengers)required | string | pattern: ^\d{4}-\d{2}-\d{2}$ |
contactrequired | object | |
email (in contact)required | string (email) | pattern: ^(?:[A-Za-z0-9_'+\-]+\.)*[A-Za-z0-9_'+\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$max length: 254 |
phone (in contact)required | string | pattern: ^\+[1-9]\d{6,14}$ |
idempotencyKeyrequired | string | pattern: ^[A-Za-z0-9._:-]{8,100}$ |
scenario | string | one of: "happy", "flaky_supplier", "price_up", "sold_out", "payment_declined", "payment_timeout", "issue_fail", "issue_unknown", "notify_fail" |
{
"offerId": "eyJx….sig",
"brand": "Standard",
"idempotencyKey": "6f1c2d3e-checkout",
"contact": {
"email": "aziz@example.uz",
"phone": "+998901234567"
},
"passengers": [
{
"type": "ADT",
"firstName": "AZIZ",
"lastName": "KARIMOV",
"birthDate": "1990-04-02",
"gender": "M",
"citizenship": "UZ",
"documentNumber": "FA1234567",
"documentExpiry": "2030-01-01"
}
]
}Code samples
curl -X POST 'https://api.1fly.uz/v1/public/orders' \
-H 'Content-Type: application/json' \
-d '{
"offerId": "eyJx….sig",
"brand": "Standard",
"idempotencyKey": "6f1c2d3e-checkout",
"contact": {
"email": "aziz@example.uz",
"phone": "+998901234567"
},
"passengers": [
{
"type": "ADT",
"firstName": "AZIZ",
"lastName": "KARIMOV",
"birthDate": "1990-04-02",
"gender": "M",
"citizenship": "UZ",
"documentNumber": "FA1234567",
"documentExpiry": "2030-01-01"
}
]
}'const res = await fetch('https://api.1fly.uz/v1/public/orders', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
},
body: JSON.stringify({
"offerId": "eyJx….sig",
"brand": "Standard",
"idempotencyKey": "6f1c2d3e-checkout",
"contact": {
"email": "aziz@example.uz",
"phone": "+998901234567"
},
"passengers": [
{
"type": "ADT",
"firstName": "AZIZ",
"lastName": "KARIMOV",
"birthDate": "1990-04-02",
"gender": "M",
"citizenship": "UZ",
"documentNumber": "FA1234567",
"documentExpiry": "2030-01-01"
}
]
}),
});
const data = await res.json();
if (!res.ok) throw new Error(`${data.error.code}: ${data.error.message} (request ${data.error.requestId})`);import requests
resp = requests.post(
"https://api.1fly.uz/v1/public/orders",
json={
"offerId": "eyJx….sig",
"brand": "Standard",
"idempotencyKey": "6f1c2d3e-checkout",
"contact": {
"email": "aziz@example.uz",
"phone": "+998901234567",
},
"passengers": [
{
"type": "ADT",
"firstName": "AZIZ",
"lastName": "KARIMOV",
"birthDate": "1990-04-02",
"gender": "M",
"citizenship": "UZ",
"documentNumber": "FA1234567",
"documentExpiry": "2030-01-01",
},
],
},
timeout=30,
)
data = resp.json()
if not resp.ok:
raise RuntimeError(f"{data['error']['code']}: {data['error']['message']}")Responses
201Booked.
{
"orderId": "ord_…",
"reference": "K7QX2P",
"accessToken": "3f9a…",
"status": "draft"
}500Unexpected error on our side; quote the requestId.
| Field | Type | Description |
|---|---|---|
errorrequired | object | |
code (in error)required | string | Stable machine-readable code, e.g. VALIDATION_FAILED. |
message (in error)required | string | Human-readable explanation. |
requestId (in error)required | string | Quote this to support; also in the x-request-id header and the request log. |
issues (in error) | array<object> | Present for VALIDATION_FAILED: one entry per problem. |
path (in error.issues) | string | Example: passengers.0.lastName |
code (in error.issues) | string | |
message (in error.issues) | string |
{
"error": {
"code": "string",
"message": "string",
"requestId": "5b0c9a7e-2d1f-4e3a-9b8c-7d6e5f4a3b2c",
"issues": [
{
"path": "passengers.0.lastName",
"code": "string",
"message": "string"
}
]
}
}Follow a booking#
Traveller view: status, progress steps, payment deadline, tickets, and a plain-language failure with what to do next. Needs the access token.
Parameters
Path parameters
| Name | Type | Description |
|---|---|---|
idrequired | string | Order id, e.g. ord_7c2f… (32 hex characters). pattern: ^ord_[a-f0-9]{32}$ |
Query parameters
| Name | Type | Description |
|---|---|---|
tokenrequired | string | pattern: ^[a-f0-9]{32}$ |
lang | string | one of: "uz", "ru", "en"default: "en" |
Code samples
curl 'https://api.1fly.uz/v1/public/orders/ord_0d6c3f8a2b9e4c1d8f7a6b5c4d3e2f10?token=abcdef0123456789abcdef0123456789'const res = await fetch('https://api.1fly.uz/v1/public/orders/ord_0d6c3f8a2b9e4c1d8f7a6b5c4d3e2f10?token=abcdef0123456789abcdef0123456789');
const data = await res.json();
if (!res.ok) throw new Error(`${data.error.code}: ${data.error.message} (request ${data.error.requestId})`);import requests
resp = requests.get(
"https://api.1fly.uz/v1/public/orders/ord_0d6c3f8a2b9e4c1d8f7a6b5c4d3e2f10",
params={"token": "abcdef0123456789abcdef0123456789"},
timeout=30,
)
data = resp.json()
if not resp.ok:
raise RuntimeError(f"{data['error']['code']}: {data['error']['message']}")Responses
200Booking.
{}500Unexpected error on our side; quote the requestId.
| Field | Type | Description |
|---|---|---|
errorrequired | object | |
code (in error)required | string | Stable machine-readable code, e.g. VALIDATION_FAILED. |
message (in error)required | string | Human-readable explanation. |
requestId (in error)required | string | Quote this to support; also in the x-request-id header and the request log. |
issues (in error) | array<object> | Present for VALIDATION_FAILED: one entry per problem. |
path (in error.issues) | string | Example: passengers.0.lastName |
code (in error.issues) | string | |
message (in error.issues) | string |
{
"error": {
"code": "string",
"message": "string",
"requestId": "5b0c9a7e-2d1f-4e3a-9b8c-7d6e5f4a3b2c",
"issues": [
{
"path": "passengers.0.lastName",
"code": "string",
"message": "string"
}
]
}
}Pay (test mode)#
Simulates the bank’s answer; behaves exactly like a payment provider callback.
Parameters
Path parameters
| Name | Type | Description |
|---|---|---|
idrequired | string | Order id, e.g. ord_7c2f… (32 hex characters). pattern: ^ord_[a-f0-9]{32}$ |
Query parameters
| Name | Type | Description |
|---|---|---|
tokenrequired | string | pattern: ^[a-f0-9]{32}$ |
Request body application/json required
| Field | Type | Description |
|---|---|---|
methodrequired | string | one of: "uzcard", "humo", "visa", "mastercard", "payme", "click" |
outcomerequired | string | one of: "success", "decline" |
{
"method": "payme",
"outcome": "success"
}Code samples
curl -X POST 'https://api.1fly.uz/v1/public/orders/ord_0d6c3f8a2b9e4c1d8f7a6b5c4d3e2f10/pay?token=abcdef0123456789abcdef0123456789' \
-H 'Content-Type: application/json' \
-d '{
"method": "payme",
"outcome": "success"
}'const res = await fetch('https://api.1fly.uz/v1/public/orders/ord_0d6c3f8a2b9e4c1d8f7a6b5c4d3e2f10/pay?token=abcdef0123456789abcdef0123456789', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
},
body: JSON.stringify({
"method": "payme",
"outcome": "success"
}),
});
const data = await res.json();
if (!res.ok) throw new Error(`${data.error.code}: ${data.error.message} (request ${data.error.requestId})`);import requests
resp = requests.post(
"https://api.1fly.uz/v1/public/orders/ord_0d6c3f8a2b9e4c1d8f7a6b5c4d3e2f10/pay",
params={"token": "abcdef0123456789abcdef0123456789"},
json={
"method": "payme",
"outcome": "success",
},
timeout=30,
)
data = resp.json()
if not resp.ok:
raise RuntimeError(f"{data['error']['code']}: {data['error']['message']}")Responses
202Accepted.
{
"accepted": true
}500Unexpected error on our side; quote the requestId.
| Field | Type | Description |
|---|---|---|
errorrequired | object | |
code (in error)required | string | Stable machine-readable code, e.g. VALIDATION_FAILED. |
message (in error)required | string | Human-readable explanation. |
requestId (in error)required | string | Quote this to support; also in the x-request-id header and the request log. |
issues (in error) | array<object> | Present for VALIDATION_FAILED: one entry per problem. |
path (in error.issues) | string | Example: passengers.0.lastName |
code (in error.issues) | string | |
message (in error.issues) | string |
{
"error": {
"code": "string",
"message": "string",
"requestId": "5b0c9a7e-2d1f-4e3a-9b8c-7d6e5f4a3b2c",
"issues": [
{
"path": "passengers.0.lastName",
"code": "string",
"message": "string"
}
]
}
}Find a booking#
By reference and e-mail; returns the access token. The same answer is given whether the reference or the e-mail is wrong.
Request body application/json required
| Field | Type | Description |
|---|---|---|
referencerequired | string | pattern: ^[A-Z0-9]{6}$ |
emailrequired | string (email) | pattern: ^(?:[A-Za-z0-9_'+\-]+\.)*[A-Za-z0-9_'+\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$ |
{
"reference": "K7QX2P",
"email": "aziz@example.uz"
}Code samples
curl -X POST 'https://api.1fly.uz/v1/public/trips/lookup' \
-H 'Content-Type: application/json' \
-d '{
"reference": "K7QX2P",
"email": "aziz@example.uz"
}'const res = await fetch('https://api.1fly.uz/v1/public/trips/lookup', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
},
body: JSON.stringify({
"reference": "K7QX2P",
"email": "aziz@example.uz"
}),
});
const data = await res.json();
if (!res.ok) throw new Error(`${data.error.code}: ${data.error.message} (request ${data.error.requestId})`);import requests
resp = requests.post(
"https://api.1fly.uz/v1/public/trips/lookup",
json={
"reference": "K7QX2P",
"email": "aziz@example.uz",
},
timeout=30,
)
data = resp.json()
if not resp.ok:
raise RuntimeError(f"{data['error']['code']}: {data['error']['message']}")Responses
200Found.
{
"orderId": "ord_…",
"accessToken": "3f9a…"
}404No booking matches.
| Field | Type | Description |
|---|---|---|
errorrequired | object | |
code (in error)required | string | Stable machine-readable code, e.g. VALIDATION_FAILED. |
message (in error)required | string | Human-readable explanation. |
requestId (in error)required | string | Quote this to support; also in the x-request-id header and the request log. |
issues (in error) | array<object> | Present for VALIDATION_FAILED: one entry per problem. |
path (in error.issues) | string | Example: passengers.0.lastName |
code (in error.issues) | string | |
message (in error.issues) | string |
{
"error": {
"code": "string",
"message": "string",
"requestId": "5b0c9a7e-2d1f-4e3a-9b8c-7d6e5f4a3b2c",
"issues": [
{
"path": "passengers.0.lastName",
"code": "string",
"message": "string"
}
]
}
}500Unexpected error on our side; quote the requestId.
| Field | Type | Description |
|---|---|---|
errorrequired | object | |
code (in error)required | string | Stable machine-readable code, e.g. VALIDATION_FAILED. |
message (in error)required | string | Human-readable explanation. |
requestId (in error)required | string | Quote this to support; also in the x-request-id header and the request log. |
issues (in error) | array<object> | Present for VALIDATION_FAILED: one entry per problem. |
path (in error.issues) | string | Example: passengers.0.lastName |
code (in error.issues) | string | |
message (in error.issues) | string |
{
"error": {
"code": "string",
"message": "string",
"requestId": "5b0c9a7e-2d1f-4e3a-9b8c-7d6e5f4a3b2c",
"issues": [
{
"path": "passengers.0.lastName",
"code": "string",
"message": "string"
}
]
}
}