This is a high-level overview of a typical response from S7 Agent API.

Headers

The following table describes the HTTP headers that you received in a S7 MSE API response:



Name

Key in headers

Description

1

Date and time

date

Date and time of request execution in GMT

2

Type of content

Content-Type

The content type of the response. Always "application/xml"

3

Conversation ID

x-conversation

The identificatior of transaction.

(warning) Pass it to our technical support by email at api.support@s7.ru if you faced problems with responses

The following example shows headers of a typical response of 0.52 version API on Test environment:

Date: Thu, 20 Jul 2023 13:18:39 GMT
Content-Type: application/xml
Transfer-Encoding: chunked
Connection: keep-alive
X-Flow: 1ed1686b-cb2c-4f81-a5bd-fda6b5902042
X-Conversation: 58478262-ef5b-4e89-8c90-1d607917d413
vary: accept-encoding
Content-Encoding: gzip
Strict-Transport-Security: max-age=15724800; includeSubDomains


Table of contents:

Successful results

Successful responses typically includes the following structure (actual for 0.52 version):


<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<result id="bd858aa6-e6e8-42b2-bd68-6b3416fc430a" session="0ff7767d-7505-48b5-9929-8992b627f898" solutionCount="4" solutionSet="ed0d5377-0037-46eb-89f0-abbce67b9896">
    <solutions>
        <itinerary>
            <solution id="0b124e58-d8cb-44f7-96e4-fdd406bf4bf7" saleTotal="RUB9673" preferredFareFamily="CHEAPEST FARE">
                <ext link="https://ibe.s7.ru/mseDeeplink.action?LAN=RU&partner={{your_partner_id}}&TA=1&TC=1&TI=0&SUP=XO&CP=F&CUR=RUB&TF=9673&FLC=1&FSC1=1&FN1=1010&AC1=S7&DD1=2023-12-15&DT1=12:15:00&AD1=2023-12-15&AT1=13:55:00&DA1=LED&AA1=DME&SC1=N&utm_campaign={{your_utm_campaign}}&utm_campaign={{your_utm_source}}&utm_medium=metasearch&FF1=B">
                    <SalePriceWithoutYQ amount="5062" currency="RUB"/>
                    <SalePriceWithoutYQAndYR amount="5062" currency="RUB"/>
                    <SalePriceWithoutYR amount="5062" currency="RUB"/>
                </ext>
                <pricing paxCount="1">
                    <ext>
                        <SalePriceWithoutYQ amount="5062" currency="RUB"/>
                        <SalePriceWithoutYQAndYR amount="5062" currency="RUB"/>
                        <SalePriceWithoutYR amount="5062" currency="RUB"/>
                        <pax adults="1"/>
                    </ext>
                </pricing>
                <pricing paxCount="1">
                    <ext>
                        <SalePriceWithoutYQ amount="4611" currency="RUB"/>
                        <SalePriceWithoutYQAndYR amount="4611" currency="RUB"/>
                        <SalePriceWithoutYR amount="4611" currency="RUB"/>
                        <pax children="1"/>
                    </ext>
                </pricing>
            </solution>
            <slice>
                <segment arrival="2023-12-15T13:55+03:00" carrier="S7" departure="2023-12-15T12:15+03:00" destination="DME" duration="100" flight="S71010" origin="LED"/>
            </slice>
        </itinerary>
        <itinerary> >
        <itinerary> >
        <itinerary> >
        <itinerary>
            <solution id="0f4e91c7-897a-425e-bf40-dd14a3f10943" saleTotal="RUB9673" preferredFareFamily="CHEAPEST FARE">
                <ext link="https://ibe.s7.ru/mseDeeplink.action?LAN=RU&partner={{your_partner_id}}&TA=1&TC=1&TI=0&SUP=XO&CP=F&CUR=RUB&TF=9673&FLC=1&FSC1=1&FN1=1016&AC1=S7&DD1=2023-12-15&DT1=20:35:00&AD1=2023-12-15&AT1=22:15:00&DA1=LED&AA1=DME&SC1=N&utm_campaign={{your_utm_campaign}}&utm_campaign={{your_utm_source}}&utm_medium=metasearch&FF1=B">
                    <SalePriceWithoutYQ amount="5062" currency="RUB"/>
                    <SalePriceWithoutYQAndYR amount="5062" currency="RUB"/>
                    <SalePriceWithoutYR amount="5062" currency="RUB"/>
                </ext>
                <pricing paxCount="1">
                    <ext>
                        <SalePriceWithoutYQ amount="5062" currency="RUB"/>
                        <SalePriceWithoutYQAndYR amount="5062" currency="RUB"/>
                        <SalePriceWithoutYR amount="5062" currency="RUB"/>
                        <pax adults="1"/>
                    </ext>
                </pricing>
                <pricing paxCount="1">
                    <ext>
                        <SalePriceWithoutYQ amount="4611" currency="RUB"/>
                        <SalePriceWithoutYQAndYR amount="4611" currency="RUB"/>
                        <SalePriceWithoutYR amount="4611" currency="RUB"/>
                        <pax children="1"/>
                    </ext>
                </pricing>
            </solution>
            <slice>
                <segment arrival="2023-12-15T22:15+03:00" carrier="S7" departure="2023-12-15T20:35+03:00" destination="DME" duration="100" flight="S71016" origin="LED"/>
            </slice>
        </itinerary>
    </solutions>
</result>


For more information about received data in successful response, check RQ pages divided by operation in reference.

Unsuccessful results

Unsuccessful responses typically includes the following structure (actual for 0.52 version):


<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<result solutionCount="0">
    <error type="input">
        <message>date.is.more.than.359.days.in.future</message>
    </error>
</result>


For an unsuccessful responses, API returns Errors with technical info in the message tag.

Сheck Errors page for more information about possible errors

Common questions