2A Search Direct flight

POST /api/air/search

This endpoint is used to search for air travel options based on the provided directions and other parameters.
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 strings) - The types of fares (optional params, mayhave default value. (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 -g --request POST 'https://stage-api.etm-system.ru/api/air/search' \ --header 'Accept: application/json' \ --header 'Atm-Auth-Key: ' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: text/plain' \ --data-raw '{ "directions": [ { "departure_code": "DXB", "arrival_code": "IST", "date": "2025-05-09" // format YYYY-MM-DD } ], "adult_qnt": 1, "child_qnt": 0, "infant_qnt": 0, "providers": [ 1429 // provider id, optional ], "class": "E", "fare_types": [ "PUB", "NEG" ], "airlines": [ "HY" // optional param ] }'

{ "status": "ok", "message": "", "request_id": "e39b1016-00ac-40ab-96b1-0db93a576958", "old_request_id": null, "travel_policy_id": null, "one_order_id": 0, "show_mode": "classic", "currency": "EUR", "available_currencies": [ "AMD", "EUR", "RUB", "KZT", "KRW" ], "is_round": false, "is_multy": false, "group_avia_offers": false }

2A Search Direct flight

POST /api/air/search#

Request Body#

Response#

Request

Responses

POST /api/air/search

Request Body

Response