API reference

Public booking

Traveller site: search, fares, guest booking and payment.

Find airports#

GET/v1/public/airports

By IATA code, city or airport name in Uzbek, Russian or English. Empty q returns popular airports. Max 8 results.

Auth
Public, no credentials
Operation id
get_public_airports

Parameters

Query parameters

NameTypeDescription
qstring
max length: 60
langstring
one of: "uz", "ru", "en"default: "en"

Code samples

curl 'https://api.1fly.uz/v1/public/airports'

Responses

200Airports.
Example response
{
  "airports": [
    {
      "code": "TAS",
      "city": "Toshkent",
      "name": "Toshkent xalqaro aeroporti",
      "country": "O‘zbekiston",
      "countryCode": "UZ"
    }
  ]
}
500Unexpected error on our side; quote the requestId.
FieldTypeDescription
errorrequiredobject
code (in error)requiredstring

Stable machine-readable code, e.g. VALIDATION_FAILED.

message (in error)requiredstring

Human-readable explanation.

requestId (in error)requiredstring

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
Response (generated from schema)
{
  "error": {
    "code": "string",
    "message": "string",
    "requestId": "5b0c9a7e-2d1f-4e3a-9b8c-7d6e5f4a3b2c",
    "issues": [
      {
        "path": "passengers.0.lastName",
        "code": "string",
        "message": "string"
      }
    ]
  }
}

Start a flight search#

POST/v1/public/searches

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.

Auth
Public, no credentials
Operation id
post_public_searches

Request body application/json required

FieldTypeDescription
fromrequiredstring
pattern: ^[A-Z]{3}$
torequiredstring
pattern: ^[A-Z]{3}$
departDaterequiredstring
pattern: ^\d{4}-\d{2}-\d{2}$
returnDatestring | null
adultsrequiredinteger
range: 1–9
childreninteger
range: 0–8default: 0
infantsinteger
range: 0–9default: 0
cabinstring
one of: "economy", "business"default: "economy"
Example request body
{
  "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"
}'

Responses

201Search started.
Example response
{
  "searchId": "eyJx…",
  "expiresAt": "2026-11-17T10:10:00.000Z"
}
500Unexpected error on our side; quote the requestId.
FieldTypeDescription
errorrequiredobject
code (in error)requiredstring

Stable machine-readable code, e.g. VALIDATION_FAILED.

message (in error)requiredstring

Human-readable explanation.

requestId (in error)requiredstring

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
Response (generated from schema)
{
  "error": {
    "code": "string",
    "message": "string",
    "requestId": "5b0c9a7e-2d1f-4e3a-9b8c-7d6e5f4a3b2c",
    "issues": [
      {
        "path": "passengers.0.lastName",
        "code": "string",
        "message": "string"
      }
    ]
  }
}

Get search results#

GET/v1/public/searches/{id}

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.

Auth
Public, no credentials
Operation id
get_public_searches_id

Parameters

Path parameters

NameTypeDescription
idrequiredstring

Signed search id.

pattern: ^[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+$

Query parameters

NameTypeDescription
langstring
one of: "uz", "ru", "en"default: "en"

Code samples

curl 'https://api.1fly.uz/v1/public/searches/A.B'

Responses

200Results.
Example response
{
  "status": "running",
  "suppliersDone": 4,
  "suppliersTotal": 7,
  "offers": []
}
500Unexpected error on our side; quote the requestId.
FieldTypeDescription
errorrequiredobject
code (in error)requiredstring

Stable machine-readable code, e.g. VALIDATION_FAILED.

message (in error)requiredstring

Human-readable explanation.

requestId (in error)requiredstring

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
Response (generated from schema)
{
  "error": {
    "code": "string",
    "message": "string",
    "requestId": "5b0c9a7e-2d1f-4e3a-9b8c-7d6e5f4a3b2c",
    "issues": [
      {
        "path": "passengers.0.lastName",
        "code": "string",
        "message": "string"
      }
    ]
  }
}

Get fare options#

GET/v1/public/offers/{id}

Light, Standard and Flex with baggage, refund and change rules and prices for all passengers. Offers expire 30 minutes after the search.

Auth
Public, no credentials
Operation id
get_public_offers_id

Parameters

Path parameters

NameTypeDescription
idrequiredstring

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'

Responses

200Offer.
Example response
{}
404OFFER_EXPIRED: search again.
FieldTypeDescription
errorrequiredobject
code (in error)requiredstring

Stable machine-readable code, e.g. VALIDATION_FAILED.

message (in error)requiredstring

Human-readable explanation.

requestId (in error)requiredstring

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
Response (generated from schema)
{
  "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.
FieldTypeDescription
errorrequiredobject
code (in error)requiredstring

Stable machine-readable code, e.g. VALIDATION_FAILED.

message (in error)requiredstring

Human-readable explanation.

requestId (in error)requiredstring

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
Response (generated from schema)
{
  "error": {
    "code": "string",
    "message": "string",
    "requestId": "5b0c9a7e-2d1f-4e3a-9b8c-7d6e5f4a3b2c",
    "issues": [
      {
        "path": "passengers.0.lastName",
        "code": "string",
        "message": "string"
      }
    ]
  }
}

Book as a guest#

POST/v1/public/orders

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.

Auth
Public, no credentials
Operation id
post_public_orders

Request body application/json required

FieldTypeDescription
offerIdrequiredstring
length: 10–2000
brandrequiredstring
one of: "Light", "Standard", "Flex"
passengersrequiredarray<object>
items: 1–9
type (in passengers)requiredstring
one of: "ADT", "CHD", "INF"
firstName (in passengers)requiredstring
pattern: ^[A-Za-z]+(?:[ '-][A-Za-z]+)*$length: 1–60
lastName (in passengers)requiredstring
pattern: ^[A-Za-z]+(?:[ '-][A-Za-z]+)*$length: 1–60
birthDate (in passengers)requiredstring
pattern: ^\d{4}-\d{2}-\d{2}$
gender (in passengers)requiredstring
one of: "M", "F"
citizenship (in passengers)requiredstring
pattern: ^[A-Z]{2}$
documentNumber (in passengers)requiredstring
pattern: ^[A-Z0-9]{5,20}$
documentExpiry (in passengers)requiredstring
pattern: ^\d{4}-\d{2}-\d{2}$
contactrequiredobject
email (in contact)requiredstring (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)requiredstring
pattern: ^\+[1-9]\d{6,14}$
idempotencyKeyrequiredstring
pattern: ^[A-Za-z0-9._:-]{8,100}$
scenariostring
one of: "happy", "flaky_supplier", "price_up", "sold_out", "payment_declined", "payment_timeout", "issue_fail", "issue_unknown", "notify_fail"
Example request body
{
  "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"
    }
  ]
}'

Responses

201Booked.
Example response
{
  "orderId": "ord_…",
  "reference": "K7QX2P",
  "accessToken": "3f9a…",
  "status": "draft"
}
500Unexpected error on our side; quote the requestId.
FieldTypeDescription
errorrequiredobject
code (in error)requiredstring

Stable machine-readable code, e.g. VALIDATION_FAILED.

message (in error)requiredstring

Human-readable explanation.

requestId (in error)requiredstring

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
Response (generated from schema)
{
  "error": {
    "code": "string",
    "message": "string",
    "requestId": "5b0c9a7e-2d1f-4e3a-9b8c-7d6e5f4a3b2c",
    "issues": [
      {
        "path": "passengers.0.lastName",
        "code": "string",
        "message": "string"
      }
    ]
  }
}

Follow a booking#

GET/v1/public/orders/{id}

Traveller view: status, progress steps, payment deadline, tickets, and a plain-language failure with what to do next. Needs the access token.

Auth
Public, no credentials
Operation id
get_public_orders_id

Parameters

Path parameters

NameTypeDescription
idrequiredstring

Order id, e.g. ord_7c2f… (32 hex characters).

pattern: ^ord_[a-f0-9]{32}$

Query parameters

NameTypeDescription
tokenrequiredstring
pattern: ^[a-f0-9]{32}$
langstring
one of: "uz", "ru", "en"default: "en"

Code samples

curl 'https://api.1fly.uz/v1/public/orders/ord_0d6c3f8a2b9e4c1d8f7a6b5c4d3e2f10?token=abcdef0123456789abcdef0123456789'

Responses

200Booking.
Example response
{}
500Unexpected error on our side; quote the requestId.
FieldTypeDescription
errorrequiredobject
code (in error)requiredstring

Stable machine-readable code, e.g. VALIDATION_FAILED.

message (in error)requiredstring

Human-readable explanation.

requestId (in error)requiredstring

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
Response (generated from schema)
{
  "error": {
    "code": "string",
    "message": "string",
    "requestId": "5b0c9a7e-2d1f-4e3a-9b8c-7d6e5f4a3b2c",
    "issues": [
      {
        "path": "passengers.0.lastName",
        "code": "string",
        "message": "string"
      }
    ]
  }
}

Pay (test mode)#

POST/v1/public/orders/{id}/pay

Simulates the bank’s answer; behaves exactly like a payment provider callback.

Auth
Public, no credentials
Operation id
post_public_orders_id_pay

Parameters

Path parameters

NameTypeDescription
idrequiredstring

Order id, e.g. ord_7c2f… (32 hex characters).

pattern: ^ord_[a-f0-9]{32}$

Query parameters

NameTypeDescription
tokenrequiredstring
pattern: ^[a-f0-9]{32}$

Request body application/json required

FieldTypeDescription
methodrequiredstring
one of: "uzcard", "humo", "visa", "mastercard", "payme", "click"
outcomerequiredstring
one of: "success", "decline"
Example request body
{
  "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"
}'

Responses

202Accepted.
Example response
{
  "accepted": true
}
500Unexpected error on our side; quote the requestId.
FieldTypeDescription
errorrequiredobject
code (in error)requiredstring

Stable machine-readable code, e.g. VALIDATION_FAILED.

message (in error)requiredstring

Human-readable explanation.

requestId (in error)requiredstring

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
Response (generated from schema)
{
  "error": {
    "code": "string",
    "message": "string",
    "requestId": "5b0c9a7e-2d1f-4e3a-9b8c-7d6e5f4a3b2c",
    "issues": [
      {
        "path": "passengers.0.lastName",
        "code": "string",
        "message": "string"
      }
    ]
  }
}

Find a booking#

POST/v1/public/trips/lookup

By reference and e-mail; returns the access token. The same answer is given whether the reference or the e-mail is wrong.

Auth
Public, no credentials
Operation id
post_public_trips_lookup

Request body application/json required

FieldTypeDescription
referencerequiredstring
pattern: ^[A-Z0-9]{6}$
emailrequiredstring (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,}$
Example request body
{
  "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"
}'

Responses

200Found.
Example response
{
  "orderId": "ord_…",
  "accessToken": "3f9a…"
}
404No booking matches.
FieldTypeDescription
errorrequiredobject
code (in error)requiredstring

Stable machine-readable code, e.g. VALIDATION_FAILED.

message (in error)requiredstring

Human-readable explanation.

requestId (in error)requiredstring

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
Response (generated from schema)
{
  "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.
FieldTypeDescription
errorrequiredobject
code (in error)requiredstring

Stable machine-readable code, e.g. VALIDATION_FAILED.

message (in error)requiredstring

Human-readable explanation.

requestId (in error)requiredstring

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
Response (generated from schema)
{
  "error": {
    "code": "string",
    "message": "string",
    "requestId": "5b0c9a7e-2d1f-4e3a-9b8c-7d6e5f4a3b2c",
    "issues": [
      {
        "path": "passengers.0.lastName",
        "code": "string",
        "message": "string"
      }
    ]
  }
}
API version v0.0.1 · Spec generated from source on 2026-11-22Changelog · Prices in so‘m (UZS)