HOTELS API
π ETS Group Travel API Documentation
π§ API Structure
B2B Login β for partners and corporate clients to obtain a session tokenB2C Login β for end-user login in direct integrationsπ Authorization Methods
B2B Login
POST{{url}}/api/loginx-www-form-urlencoded):login (string): Partner loginpassword (string): Partner password{
"etm_auth_key": "64a29a428a4edd87447ada97971be867",
"locale": "RU",
"currency": "EUR",
"max_expiry_time": 1732025832,
"max_timeout": 21600
}B2C Login
GET{{url}}/api/login/{{app_id}}?locale=EN{
"etm_auth_key": "3efc4f60938c54481782b0570d89ec9c",
"locale": "EN",
"currency": "EUR",
"max_expiry_time": 1734107412,
"max_timeout": 21600,
"site": {...},
"agent": {...}
}βοΈ Air API
π Search Flights
POST /api/air/search{
"directions": [
{
"departure_code": "MOW",
"arrival_code": "AYT",
"date": "2025-09-01",
"dir_number": 1
}
],
"adult_qnt": 1,
"child_qnt": 0,
"infant_qnt": 0,
"class": "Y",
"fare_types": ["economy"]
}{
"status": "ok",
"request_id": "abc123",
"currency": "EUR",
"is_round": false,
"is_multy": false
}π Get Airline Offers
GET /api/air/offers?request_id={{request_id}}GET /api/documents/types/site?locale=DE&pid={{pcc_id}}π‘ Smart Offer
GET /api/air/offers/{{buy_id}}/smart_ffπ Availability
GET /api/air/offers/{{buy_uid}}/availabilityπ Additional Services
GET /api/air/offers/{{request_id}}/additional-services?segment={{buy_id}}POST /api/air/offers/{{request_id}}/servicesποΈ Create Air Order
POST /api/air/orders{
"buy_id": "12345",
"phone": {"code": "+49", "number": "12345678"},
"emails": ["john.doe@mail.com"],
"passengers": [
{
"type": "ADT",
"gender": "M",
"first_name": "John",
"last_name": "Doe",
"birth_date": "1990-01-01",
"document": {
"type": "PASSPORT",
"number": "123456789"
}
}
]
}T β TicketingV β VoidB β BookingE β ErrorK β Not finished (delayed issuance)G, A, U β Group bookingsπ³ Air Payment
POST /api/air/orders/{{order_id}}/paymentGET /api/air/orders/{{order_id}}/paymentβ Air Cancellations / Refunds
POST /api/air/orders/{{order_id}}/voidPOST /api/air/orders/{{order_id}}/refundπ¨ Hotels API
π Search Destinations
GET /api/hotels/v2/dictionaries/destinationsfilter β e.g. Istanbullocale β e.g. ENπ¨ Search Hotel Offers
POST /api/hotels/v2/search{
"destination_id": 78962,
"checkin": "2025-10-01",
"checkout": "2025-10-05",
"rooms": [
{
"adults": 2,
"children": [5]
}
],
"currency": "EUR",
"locale": "EN"
}π Hotel Details
GET /api/hotels/v2/offers/{{request_id}}ποΈ Create Hotel Order
POST /api/hotels/v2/orders{
"offer_id": "DLX123",
"guests": [
{
"first_name": "John",
"last_name": "Doe",
"birth_date": "1990-01-01",
"document": {
"type": "PASSPORT",
"number": "123456789"
}
}
],
"contact": {
"phone": "+123456789",
"email": "john.doe@mail.com"
}
}π³ Hotel Payment
POST /api/hotels/v2/orders/{{order_id}}/paymentβ Hotel Void / Refund
POST /api/hotels/v2/orders/{{order_id}}/voidPOST /api/hotels/v2/orders/{{order_id}}/refundπ API Version
v1 (last updated: July 2025)v2 (last updated: March 2025)π§ͺ How to Use This Portal
1.
2.
3.
from = MOW, to = AYT or destination = Istanbul)4.
π¬ Support and Contacts
π© support@etsgroup.travel
Modified atΒ 2025-08-31 05:06:15