2B Search Multi-City

POST /api/air/search

In the response to this request, you will not receive an array of offers; instead, you’ll get a request_id.
This request_id will be used in the subsequent Offers request request to retrieve the array of offers.

Request Body

directions (array of objects) - Specifies the departure and arrival details for the travel.

departure_country (string) - The departure country code. (optional)

departure_name (string) - The name of the departure location.(optional)

departure_code (string) - The code of the departure location. (mandatory)

departure_city (string) - The city of the departure location.(optional)

arrival_country (string) - The arrival country code. (optional)

arrival_name (string) - The name of the arrival location. (optional)

arrival_code (string) - The code of the arrival location.(mandatory)

arrival_city (string) - The city of the arrival location.(optional)

date (string) - The date of travel. (mandatory)

dir_number (number) - The direction number. (optional)

adult_qnt (number) - The quantity of adult passengers. Should be more, then "0"

child_qnt (number) - The quantity of child passengers. Can be "0"

infant_qnt (number) - The quantity of infant passengers. Can be "0"

class (string) - The class of travel. (mandatory)

onlyRefundable (boolean) - If set to true, the response will only include options that support a refund policy. Non-refundable offers are excluded from the results. (optional)

fare_types (array of codes) - codes of fare types. (optional)

providers (array of numbers) - The types of providers ids (optional).

airlines (array of strings codes) - The types of airlines codes (optional).

The parameter fare_type: "CHARTER" has been removed.
New tags have been introduced:

is_charter: indicates whether the fare is a charter flight (true/false)

charterType: defines the charter type ('regular' or 'block_of_seats')

Response

The response is in JSON format and follows the schema below:

{
  "type": "object",
  "properties": {
    "status": { "type": "string" },
    "message": { "type": "string" },
    "request_id": { "type": "string" },
    "old_request_id": { "type": ["string", "null"] },
    "travel_policy_id": { "type": ["string", "null"] },
    "one_order_id": { "type": "number" },
    "show_mode": { "type": "string" },
    "currency": { "type": "string" },
    "available_currencies": { "type": "array", "items": { "type": "string" } },
    "is_round": { "type": "boolean" },
    "is_multy": { "type": "boolean" },
    "group_avia_offers": { "type": "boolean" },
    "is_groups": { "type": "number" }
  }
}

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

curl --location --globoff 'https://stage-api.etm-system.ru/api/air/search' \ --header 'Accept: application/json' \ --header 'Etm-Auth-Key: ' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: text/plain' \ --data '{ "directions": [ { "departure_code": "kul", "arrival_code": "ist", "date": "2026-07-31" // format YYYY-MM-DD }, { "departure_code": "IST", "arrival_code": "sin", "date": "2026-08-03" // format YYYY-MM-DD } ], "class": "E", "fare_types": [ "PUB", "NEG" ], "adult_qnt": 1, "child_qnt": 0, "infant_qnt": 0, "providers": [1794 // provider id, optional ] }'

{ "status": "ok", "message": "", "request_id": "f635c624-35cb-470d-912b-6d19336a954e", "old_request_id": null, "travel_policy_id": null, "one_order_id": 0, "show_mode": "classic", "currency": "EUR", "available_currencies": [ "RUB", "TRY", "EUR", "KGS", "USD", "AED", "UZS", "KZT", "SAR", "KWD" ], "is_round": false, "is_multy": true, "group_avia_offers": false, "is_groups": 0, "rules_log": false, "search_log": false }

2B Search Multi-City

POST /api/air/search#

Request Body#

Response#

Request

Responses

POST /api/air/search

Request Body

Response