API provides:

  • General shopping flow: searching, booking and ticketing flight solutions;
  • Service operations with bookings (read, change and cancel) and tickets (read and void);
  • Information such as flight details, ancillaries and fare pricing, raw fare rules directly from S7. 

Also service makes available shopping with 3D agreements (Agent sell S7 flights for theirs corporate clients with special discounts).

All operations use synchronous behaviour, generally stateless model and IATA NDC schema v15.2

Before you can send a request to S7 Agent API, you must get an SSL certificate and configure your software.


Table of contents:

Page tree:

Operation list

Legend: (tick) — available in the version, (error) — not available in the version

#Operation nameInput messageOutput messagev0.21v0.35v0.47Description / Use casesSamples
1searchFlightsFlexAirShoppingRQAirShoppingRS(error)(error)(tick)Search operation finds one cheapest solution for each day of given range for the specified search criteria



2searchFlightsAirShoppingRQAirShoppingRS(tick)(tick)(tick)

Search flights request for the specified itinerary data and search type
(low fare, smart choice or flight info search)



3findRulesFareRulesRQFareRulesRS(tick)(tick)(tick)

Returns the filed details of a specific fare basis code


4seatMapSeatAvailabilityRQSeatAvailabilityRS(tick)(tick)(tick)

Returns data used to construct seat maps with prices


5servicePriceServicePriceRQServicePriceRS(tick)(tick)(tick)

Returns pricing of ancillary services



6bookOrderCreateRQOrderViewRS(tick)(tick)(tick)Creates new reservation (PNR) in reservation system



7readOrderRetrieveRQOrderViewRS(tick)(tick)(tick)Returns information about existing PNR by PNR number
8changeBookOrderChangeRQOrderViewRS(tick)(tick)(tick)

Modification of PNR by specifying which PNR items to change and what to change
(add/change/delete ancillary services, remarks or passengers information)


9cancelBookingOrderCancelRQOrderCancelRS(tick)(tick)(tick)Operation of cancellation of a specified PNR, and returns confirmation of cancellation
10repriceItinReshopRQItinReshopRS(tick)(tick)(tick)Operation returns the actual fares (for ticketing operation) according to the specified itinerary parameters



11demandTicketsAirDocIssueRQAirDocDisplayRS(tick)(tick)(tick)

Operation set requests an Airline to issue flight (ETK) and/or ancillary (EMD) document(s)



12retrieveTicketAirDocDisplayRQAirDocDisplayRS(tick)(tick)(tick)Returns information about existing ETK/EMD by ETK/EMD number
13voidTicketAirDocVoidRQAirDocVoidRS(tick)(tick)(tick)Allows to void existing ETK
14agentPaymentOrderCreateRQOrderViewRS(error)(tick)(tick)

Create booking by flight solution, proceed payment, issue ETK for all passengers and send receipts to lead passenger

It is not public. Request our technical support for access to documentation by JIRA or email at api.support@s7.ru