4C Offer Rules
GET
{{AVIA_URL}}/api/air/offers/{{buy_id}}/rules
GET /api/air/offers/{{buy_id}}/rules
buy_id.This call is typically used after a 4 Offers request (or similar booking-selection step) to fetch the full fare rules — including penalties, seasonality, and sales restrictions — for the routes and flights associated with that
buy_id.This method is optional in the general booking flow. If fare rules are not needed for your use case, this call can be skipped, and you can proceed directly to the next step in the booking process.
The response is in JSON format and includes various fields.
Request
buy_id parameter, identifying the offer for which fare rules should be retrieved. You can take it from /api/air/offers or api/air/offers/{{buy_id}}/smart_ff, for example, response.data.offers[0].offers[0].segments[0].buy_id.Notes
rules.blocks.blocks array breaks fare rules into discrete categories (seasonality, stay restrictions, blackout dates, sales restrictions, penalties, and rule application) for programmatic access, while full_rules provides the same information pre-formatted as HTML for direct display.Request
Header Params
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --globoff 'https://stage-api.etm-system.ru/api/air/offers/{{buy_id}}/rules' \
--header 'Etm-Auth-Key: ' \
--header 'Cookie: etmsessid=8Pwz9vY4oXUDj7ojfR5u1VdXsMW6xOVYosNxo08d'Response Response Example
{
"status": "ok",
"message": "Успешно",
"buy_id": "2275093267",
"currency": "RUB",
"non_refund_tax": 0,
"routes": [
{
"id": 2275093267,
"transaction_id": 48273893,
"dir_number": 1,
"stops_number": 1,
"duration": "20:10",
"flights": [
{
"flight_number_code": "4990",
"flight_number_name": "QR-4990",
"airplane_name": "350",
"airline_name": "Qatar Airways",
"departure_date": "2026-07-31",
"departure_time": "21:00",
"departure_timezone": "+08:00",
"departure_city": "Куала-Лумпур",
"departure_airport_code": "KUL",
"departure_airport_name": "Куала-Лумпур",
"departure_terminal": "1",
"arrival_date": "2026-07-31",
"arrival_time": "23:30",
"arrival_timezone": "+03:00",
"arrival_city": "Доха",
"arrival_airport_code": "DOH",
"arrival_airport_name": "Доха",
"arrival_terminal": "",
"fare_basis": "SLR9R1SI",
"ff_name": null,
"baggage": "30Kg",
"service_class": "Эконом",
"booking_class": "S",
"ifs": [],
"rules": {
"blocks": {
"airline": "QR",
"fare": "SLR9R1SI",
"baggage": "30",
"blocks": [
{
"key": "seasonability",
"lbl": "Cезонность",
"val": "SE.SEASONS\rFROM/TO MALAYSIA FOR LOW/OFF-PEAK SEASON FARES\r \r PERMITTED 19DEC THROUGH 11MAR OR 23MAR THROUGH 26AUG OR\r 05SEP THROUGH 02DEC ON THE FIRST INTERNATIONAL SECTOR.\r"
},
{
"key": "minimum_stay",
"lbl": "Минимальные сроки пребывания",
"val": "MN.MIN STAY\r NONE UNLESS OTHERWISE SPECIFIED\r"
},
{
"key": "maximum_stay",
"lbl": "Максимальные сроки пребывания",
"val": "MX.MAX STAY\r NONE UNLESS OTHERWISE SPECIFIED\r"
},
{
"key": "blackout_dates",
"lbl": "Даты отмены рейса",
"val": "BO.BLACKOUTS\r NONE UNLESS OTHERWISE SPECIFIED\r"
},
{
"key": "sales_restrictions",
"lbl": "Ограничения на продажу",
"val": "SR.SALES RESTRICT\r \r SALE IS RESTRICTED TO SPECIFIC AGENTS.\r PAYMENT MAY ONLY BE MADE IN USD.\r TICKETS MAY BE ISSUED BY PTA.\r TICKETS MAY ONLY BE SOLD IN ETHIOPIA.\r NOTE -\r ALL BOOKINGS MUST ADHERE FULLY TO QR BOOKING\r POLICY AND BOOKING MUST ALWAYS BE DONE AS PER\r FULL ORIGIN AND DESTINATION AVAILABILITY.\r ANY VIOLATION WILL BE SUBJECT TO ADM AND ACCESS\r TO QR INVENTORY WILL BE CLOSED IN CASE OF\r PERSISTENT VIOLATIONS.\r -----\r PLEASE REFER TO GGAIRQRBTP\r FOR FURTHER DETAILS OF QR PROHIBITED BOOKING\r PRACTICES FOR AMADEUS USERS\r -----\r DRS.SABRE.COM FOR SABRE USERS\r -----\r G/AIR/QR0/P4 FOR WORLDSPAN USERS\r -----\r GCDISPLAYQR FOR GALILEO USERS\r -----\r FOR FURTHER INFORMATION PLEASE CONTACT LOCAL QR\r OFFICES OR LOCAL GDS HELPDESK\r --------------------------------------------------\r OR - SALE IS RESTRICTED TO SPECIFIC AGENTS.\r PAYMENT MAY ONLY BE MADE IN USD.\r TICKETS MAY BE ISSUED BY PTA.\r TICKETS MAY ONLY BE SOLD IN ETHIOPIA.\r NOTE -\r ALL BOOKINGS MUST ADHERE FULLY TO QR BOOKING\r POLICY AND BOOKING MUST ALWAYS BE DONE AS PER\r FULL ORIGIN AND DESTINATION AVAILABILITY.\r ANY VIOLATION WILL BE SUBJECT TO ADM AND ACCESS\r TO QR INVENTORY WILL BE CLOSED IN CASE OF\r PERSISTENT VIOLATIONS.\r -----\r PLEASE REFER TO GGAIRQRBTP\r FOR FURTHER DETAILS OF QR PROHIBITED BOOKING\r PRACTICES FOR AMADEUS USERS\r -----\r Modified at 2026-07-21 12:05:25