Service List

This allows sellers/aggregators to shop for available ancillaries for an existing order. This step will initiate/build on top of a servicing shopping session directly related to the existing order requested. This message response will return a la carte offer items representing ancillaries enclosed in an a la carte offer. The response information from this step is required in IATA_OrderQuoteRQ to price the selection of ancillaries are the following:

  • ALaCarteOfferID
  • ALaCarteOfferItemIDs of selected ancillaries
  • Flight Reference of selected ancillaries (PaxJourneyRefID / PaxSegmentRefID / DatedOperatingLegRefID)
  • PaxRefIDs of the passengers to be assigned to the ancillary

Access flight booking options through IATA’s NDC standards for enhanced distribution.

POST: v21.3/ServiceList

Header Type Header Value
Sample RQ Header HTTP Method POST
URL v21.3/ServiceList
HTTP Version HTTP/1.1
Content Type Application/Xml; Charset=Utf-8
Host client.ndc.navitaire.com
Content Length 2101
Expect 100-continue
Accept-Encoding gzip, deflate
Connection Keep Alive
Sample RS Header HTTP Version & Status Code HTTP/1.1 200 OK
Content-Type Application/Xml; Charset=Utf-8
Cache-Control Private
Content-Encoding gzip
Vary Accept Encoding
Accept application/xml
XML Request Response Error And Error Handling Work Flow FAQ

Below is an example of an XML snippet

Service List Request

Below is a sample XML request of the Aviation APIs:

<IATA_ServiceListRQ  xmlns="http://www.iata.org/IATA/2015/EASD/00/IATA_OffersAndOrdersMessage">
    <DistributionChain>
        <DistributionChainLink xmlns="http://www.iata.org/IATA/2015/EASD/00/IATA_OffersAndOrdersCommonTypes">
            <Ordinal>1</Ordinal>
            <OrgRole>Seller</OrgRole>
            <ParticipatingOrg>
                <OrgID>{{OrgID}}</OrgID>
            </ParticipatingOrg>
        </DistributionChainLink>
    </DistributionChain>
    <PayloadAttributes>
        <VersionNumber xmlns="http://www.iata.org/IATA/2015/EASD/00/IATA_OffersAndOrdersCommonTypes">21.3</VersionNumber>
    </PayloadAttributes>
    <POS>
        <Country xmlns="http://www.iata.org/IATA/2015/EASD/00/IATA_OffersAndOrdersCommonTypes">
            <CountryCode>IN</CountryCode>
        </Country>
    </POS>
    <Request>
        <ServiceListCoreRequest xmlns="http://www.iata.org/IATA/2015/EASD/00/IATA_OffersAndOrdersCommonTypes">
            <OfferRequest>
                <Offer>
                    <OfferID>01648755647_id-3452fece-653d-4950-a950-8762aa8b439c-o-1</OfferID>
                    <OwnerCode>6E</OwnerCode>
                </Offer>
            </OfferRequest>
        </ServiceListCoreRequest>
    </Request>
</IATA_ServiceListRQ>

Service List Response

Below is a sample XML response of the Aviation APIs:

<IATA_ServiceListRS xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://www.iata.org/IATA/2015/EASD/00/IATA_OffersAndOrdersMessage">
    <Response>
        <ALaCarteOffer xmlns="http://www.iata.org/IATA/2015/EASD/00/IATA_OffersAndOrdersCommonTypes">
            <OfferExpirationTimeLimitDateTime>2025-04-11T09:55:42.0461672Z</OfferExpirationTimeLimitDateTime>
            <OfferID>id-fcaa176d-d4b5-40bd-829a-3756ad7dfa14</OfferID>
            <OfferItem>
                <Eligibility>
                    <OfferFlightAssociations>
                        <PaxJourneyRef>
                            <PaxJourneyRefID>fl628363567</PaxJourneyRefID>
                        </PaxJourneyRef>
                    </OfferFlightAssociations>
                    <PaxRefID>ADT0</PaxRefID>
                    <PaxRefID>CHD1</PaxRefID>
                </Eligibility>
                <OfferItemID>id-fcaa176d-d4b5-40bd-829a-3756ad7dfa14-1</OfferItemID>
                <Service>
                    <ServiceDefinitionRefID>def00424748883</ServiceDefinitionRefID>
                    <ServiceID>id-fcaa176d-d4b5-40bd-829a-3756ad7dfa14-1</ServiceID>
                </Service>
                <UnitPrice>
                    <BaseAmount CurCode="INR">0.00</BaseAmount>
                    <TaxSummary>
                        <TotalTaxAmount CurCode="INR">0.00</TotalTaxAmount>
                    </TaxSummary>
                    <TotalAmount CurCode="INR">0.00</TotalAmount>
                </UnitPrice>
            </OfferItem>
            <OfferItem>
                <Eligibility>
                    <OfferFlightAssociations>
                        <PaxJourneyRef>
                            <PaxJourneyRefID>fl628363567</PaxJourneyRefID>
                        </PaxJourneyRef>
                    </OfferFlightAssociations>
                    <PaxRefID>ADT0</PaxRefID>
                    <PaxRefID>CHD1</PaxRefID>
                </Eligibility>
                <OfferItemID>id-fcaa176d-d4b5-40bd-829a-3756ad7dfa14-2</OfferItemID>
                <Service>
                    <ServiceDefinitionRefID>def00583326564</ServiceDefinitionRefID>
                    <ServiceID>id-fcaa176d-d4b5-40bd-829a-3756ad7dfa14-2</ServiceID>
                </Service>
                <UnitPrice>
                    <BaseAmount CurCode="INR">0.00</BaseAmount>
                    <TaxSummary>
                        <TotalTaxAmount CurCode="INR">0.00</TotalTaxAmount>
                    </TaxSummary>
                    <TotalAmount CurCode="INR">0.00</TotalAmount>
                </UnitPrice>
            </OfferItem>
            <OfferItem>
                <Eligibility>
                    <OfferFlightAssociations>
                        <PaxJourneyRef>
                            <PaxJourneyRefID>fl628363567</PaxJourneyRefID>
                        </PaxJourneyRef>
                    </OfferFlightAssociations>
                    <PaxRefID>ADT0</PaxRefID>
                    <PaxRefID>CHD1</PaxRefID>
                </Eligibility>
                <OfferItemID>id-fcaa176d-d4b5-40bd-829a-3756ad7dfa14-3</OfferItemID>
                <Service>
                    <ServiceDefinitionRefID>def00711466633</ServiceDefinitionRefID>
                    <ServiceID>id-fcaa176d-d4b5-40bd-829a-3756ad7dfa14-3</ServiceID>
                </Service>
                <UnitPrice>
                    <BaseAmount CurCode="INR">2200.00</BaseAmount>
                    <TaxSummary>
                        <TotalTaxAmount CurCode="INR">0.00</TotalTaxAmount>
                    </TaxSummary>
                    <TotalAmount CurCode="INR">2200.00</TotalAmount>
                </UnitPrice>
            </OfferItem>
            <OfferItem>
                <Eligibility>
                    <OfferFlightAssociations>
                        <DatedOperatingLegRef>
                            <DatedOperatingLegRefID>seg628363567-leg0</DatedOperatingLegRefID>
                        </DatedOperatingLegRef>
                    </OfferFlightAssociations>
                    <PaxRefID>ADT0</PaxRefID>
                    <PaxRefID>CHD1</PaxRefID>
                </Eligibility>
                <OfferItemID>id-fcaa176d-d4b5-40bd-829a-3756ad7dfa14-4</OfferItemID>
                <Service>
                    <ServiceDefinitionRefID>def01148323892</ServiceDefinitionRefID>
                    <ServiceID>id-fcaa176d-d4b5-40bd-829a-3756ad7dfa14-4</ServiceID>
                </Service>
                <UnitPrice>
                    <BaseAmount CurCode="INR">339.00</BaseAmount>
                    <TaxSummary>
                        <Tax>
                            <Amount CurCode="INR">61.00</Amount>
                            <DescText>GST for Lakshadweep</DescText>
                            <FiledTaxCode>GST</FiledTaxCode>
                            <TaxCode>K3</TaxCode>
                            <TaxName>GST for Lakshadweep</TaxName>
                        </Tax>
                        <TotalTaxAmount CurCode="INR">61.00</TotalTaxAmount>
                    </TaxSummary>
                    <TotalAmount CurCode="INR">400.00</TotalAmount>
                </UnitPrice>
            </OfferItem>
            <OfferItem>
                <Eligibility>
                    <OfferFlightAssociations>
                        <DatedOperatingLegRef>
                            <DatedOperatingLegRefID>seg628363567-leg0</DatedOperatingLegRefID>
                        </DatedOperatingLegRef>
                    </OfferFlightAssociations>
                    <PaxRefID>ADT0</PaxRefID>
                    <PaxRefID>CHD1</PaxRefID>
                </Eligibility>
                <OfferItemID>id-fcaa176d-d4b5-40bd-829a-3756ad7dfa14-5</OfferItemID>
                <Service>
                    <ServiceDefinitionRefID>def00137319214</ServiceDefinitionRefID>
                    <ServiceID>id-fcaa176d-d4b5-40bd-829a-3756ad7dfa14-5</ServiceID>
                </Service>
                <UnitPrice>
                    <BaseAmount CurCode="INR">339.00</BaseAmount>
                    <TaxSummary>
                        <Tax>
                            <Amount CurCode="INR">61.00</Amount>
                            <DescText>GST for Lakshadweep</DescText>
                            <FiledTaxCode>GST</FiledTaxCode>
                            <TaxCode>K3</TaxCode>
                            <TaxName>GST for Lakshadweep</TaxName>
                        </Tax>
                        <TotalTaxAmount CurCode="INR">61.00</TotalTaxAmount>
                    </TaxSummary>
                    <TotalAmount CurCode="INR">400.00</TotalAmount>
                </UnitPrice>
            </OfferItem>
            <OfferItem>
                <Eligibility>
                    <OfferFlightAssociations>
                        <DatedOperatingLegRef>
                            <DatedOperatingLegRefID>seg628363567-leg0</DatedOperatingLegRefID>
                        </DatedOperatingLegRef>
                    </OfferFlightAssociations>
                    <PaxRefID>ADT0</PaxRefID>
                    <PaxRefID>CHD1</PaxRefID>
                </Eligibility>
                <OfferItemID>id-fcaa176d-d4b5-40bd-829a-3756ad7dfa14-6</OfferItemID>
                <Service>
                    <ServiceDefinitionRefID>def00137330211</ServiceDefinitionRefID>
                    <ServiceID>id-fcaa176d-d4b5-40bd-829a-3756ad7dfa14-6</ServiceID>
                </Service>
                <UnitPrice>
                    <BaseAmount CurCode="INR">339.00</BaseAmount>
                    <TaxSummary>
                        <Tax>
                            <Amount CurCode="INR">61.00</Amount>
                            <DescText>GST for Lakshadweep</DescText>
                            <FiledTaxCode>GST</FiledTaxCode>
                            <TaxCode>K3</TaxCode>
                            <TaxName>GST for Lakshadweep</TaxName>
                        </Tax>
                        <TotalTaxAmount CurCode="INR">61.00</TotalTaxAmount>
                    </TaxSummary>
                    <TotalAmount CurCode="INR">400.00</TotalAmount>
                </UnitPrice>
            </OfferItem>
            <OfferItem>
                <Eligibility>
                    <OfferFlightAssociations>
                        <DatedOperatingLegRef>
                            <DatedOperatingLegRefID>seg628363567-leg0</DatedOperatingLegRefID>
                        </DatedOperatingLegRef>
                    </OfferFlightAssociations>
                    <PaxRefID>ADT0</PaxRefID>
                    <PaxRefID>CHD1</PaxRefID>
                </Eligibility>
                <OfferItemID>id-fcaa176d-d4b5-40bd-829a-3756ad7dfa14-7</OfferItemID>
                <Service>
                    <ServiceDefinitionRefID>def0175671061</ServiceDefinitionRefID>
                    <ServiceID>id-fcaa176d-d4b5-40bd-829a-3756ad7dfa14-7</ServiceID>
                </Service>
                <UnitPrice>
                    <BaseAmount CurCode="INR">339.00</BaseAmount>
                    <TaxSummary>
                        <Tax>
                            <Amount CurCode="INR">61.00</Amount>
                            <DescText>GST for Lakshadweep</DescText>
                            <FiledTaxCode>GST</FiledTaxCode>
                            <TaxCode>K3</TaxCode>
                            <TaxName>GST for Lakshadweep</TaxName>
                        </Tax>
                        <TotalTaxAmount CurCode="INR">61.00</TotalTaxAmount>
                    </TaxSummary>
                    <TotalAmount CurCode="INR">400.00</TotalAmount>
                </UnitPrice>
            </OfferItem>
            <OfferItem>
                <Eligibility>
                    <OfferFlightAssociations>
                        <DatedOperatingLegRef>
                            <DatedOperatingLegRefID>seg628363567-leg0</DatedOperatingLegRefID>
                        </DatedOperatingLegRef>
                    </OfferFlightAssociations>
                    <PaxRefID>ADT0</PaxRefID>
                    <PaxRefID>CHD1</PaxRefID>
                </Eligibility>
                <OfferItemID>id-fcaa176d-d4b5-40bd-829a-3756ad7dfa14-8</OfferItemID>
                <Service>
                    <ServiceDefinitionRefID>def0175671062</ServiceDefinitionRefID>
                    <ServiceID>id-fcaa176d-d4b5-40bd-829a-3756ad7dfa14-8</ServiceID>
                </Service>
                <UnitPrice>
                    <BaseAmount CurCode="INR">339.00</BaseAmount>
                    <TaxSummary>
                        <Tax>
                            <Amount CurCode="INR">61.00</Amount>
                            <DescText>GST for Lakshadweep</DescText>
                            <FiledTaxCode>GST</FiledTaxCode>
                            <TaxCode>K3</TaxCode>
                            <TaxName>GST for Lakshadweep</TaxName>
                        </Tax>
                        <TotalTaxAmount CurCode="INR">61.00</TotalTaxAmount>
                    </TaxSummary>
                    <TotalAmount CurCode="INR">400.00</TotalAmount>
                </UnitPrice>
            </OfferItem>
            <OfferItem>
                <Eligibility>
                    <OfferFlightAssociations>
                        <DatedOperatingLegRef>
                            <DatedOperatingLegRefID>seg628363567-leg0</DatedOperatingLegRefID>
                        </DatedOperatingLegRef>
                    </OfferFlightAssociations>
                    <PaxRefID>ADT0</PaxRefID>
                    <PaxRefID>CHD1</PaxRefID>
                </Eligibility>
                <OfferItemID>id-fcaa176d-d4b5-40bd-829a-3756ad7dfa14-9</OfferItemID>
                <Service>
                    <ServiceDefinitionRefID>def0175671063</ServiceDefinitionRefID>
                    <ServiceID>id-fcaa176d-d4b5-40bd-829a-3756ad7dfa14-9</ServiceID>
                </Service>
                <UnitPrice>
                    <BaseAmount CurCode="INR">339.00</BaseAmount>
                    <TaxSummary>
                        <Tax>
                            <Amount CurCode="INR">61.00</Amount>
                            <DescText>GST for Lakshadweep</DescText>
                            <FiledTaxCode>GST</FiledTaxCode>
                            <TaxCode>K3</TaxCode>
                            <TaxName>GST for Lakshadweep</TaxName>
                        </Tax>
                        <TotalTaxAmount CurCode="INR">61.00</TotalTaxAmount>
                    </TaxSummary>
                    <TotalAmount CurCode="INR">400.00</TotalAmount>
                </UnitPrice>
            </OfferItem>
            ...
        </ALaCarteOffer>
    </Response>
</IATA_ServiceListRS>
Error Description Resolution
SL4002 Invalid format in ServiceListRQ. Check and correct the syntax of your request. Ensure all required fields are included and valid.
SL2000 No ancillaries available for the request. Send a fresh OfferPriceRQ to ensure you're working with the latest offer and that the airline has a chance to return associated services.
OF4067 Attempted to add Non-informational Service fee. Ensure service fee is correct

Flow of Service List

Below is the Service List flow diagram.

AuthToken
↓
AirShopping
↓
ServiceList
↓
SeatAvailability
↓
OfferPrice
↓
OrderCreate
↓
End

Need help? Check FAQs

What is the NDC Service List message in IATA?

The Service List is used in the NDC to retrieve a list of optional services (ancillaries) that can be added to an existing Offer or Order, such as extra baggage, seat selection, meals, lounge access, etc.

How does the Service List relate to the Offer and Order flows?

Offer Flow: Enhances the base offer with additional ancillaries. Order Flow: Supplements an existing order with optional services that can be priced or added.

Is the pricing in Service List final?

Not always. Some services may require further pricing confirmation via OfferPriceRQ or OrderReshopRQ before purchase.