Order Retrieve

This allows the seller/aggregator to view the contents of the Order prior to cancellation and is an optional step before adding a la carte offers. This message may be used to allow seller/aggregator to capture auxiliary information about the order such as status, passengers, existing flights, etc. before initiating an update to add additional a la carte offers.

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

POST: v21.3/OrderRetrieve

Header Type Header Value
Sample RQ Header HTTP Method POST
URL v21.3/OrderRetrieve
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

Oder Retrieve Request

Below is a sample XML request of the Aviation APIs:

<IATA_OrderRetrieveRQ 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>
        <OrderValidationFilterCriteria xmlns="http://www.iata.org/IATA/2015/EASD/00/IATA_OffersAndOrdersCommonTypes">
            <OrderFilterCriteria>
                <OrderID>QP4KTY</OrderID>
                <OwnerCode>6E</OwnerCode>
            </OrderFilterCriteria>
        </OrderValidationFilterCriteria>
    </Request>
</IATA_OrderRetrieveRQ>

Order Retrieve Response

Below is a sample XML response of the Aviation APIs:

<IATA_OrderViewRS 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>
        <DataLists xmlns="http://www.iata.org/IATA/2015/EASD/00/IATA_OffersAndOrdersCommonTypes">
            <BaggageAllowanceList>
                <BaggageAllowance>
                    <ApplicablePartyText>Traveler</ApplicablePartyText>
                    <BaggageAllowanceID>bag01719913658</BaggageAllowanceID>
                    <TypeCode>Checked</TypeCode>
                    <WeightAllowance>
                        <MaximumWeightMeasure>15</MaximumWeightMeasure>
                        <WeightUnitOfMeasurement>KGM</WeightUnitOfMeasurement>
                    </WeightAllowance>
                </BaggageAllowance>
            </BaggageAllowanceList>
            <ContactInfoList>
                <ContactInfo>
                    <ContactInfoID>con-1</ContactInfoID>
                    <EmailAddress>
                        <EmailAddressText>rakesh.kumar20@goindigo.in</EmailAddressText>
                    </EmailAddress>
                    <Phone>
                        <ContactTypeText>Home</ContactTypeText>
                        <PhoneNumber>8978987898</PhoneNumber>
                    </Phone>
                    <PostalAddress>
                        <CityName>CIT</CityName>
                        <CountryCode>IN</CountryCode>
                        <PostalCode>122001</PostalCode>
                        <StreetText>143 Street</StreetText>
                    </PostalAddress>
                </ContactInfo>
            </ContactInfoList>
            <DatedMarketingSegmentList>
                <DatedMarketingSegment>
                    <Arrival>
                        <AircraftScheduledDateTime>2025-10-19T11:35:00</AircraftScheduledDateTime>
                        <IATA_LocationCode>AGX</IATA_LocationCode>
                    </Arrival>
                    <CarrierDesigCode>6E</CarrierDesigCode>
                    <DatedMarketingSegmentId>Mkt-seg1518674484</DatedMarketingSegmentId>
                    <DatedOperatingSegmentRefId>Opr-seg1518674484</DatedOperatingSegmentRefId>
                    <Dep>
                        <AircraftScheduledDateTime>2025-10-19T10:10:00</AircraftScheduledDateTime>
                        <IATA_LocationCode>COK</IATA_LocationCode>
                    </Dep>
                    <MarketingCarrierFlightNumberText>7005</MarketingCarrierFlightNumberText>
                </DatedMarketingSegment>
            </DatedMarketingSegmentList>
            <DatedOperatingLegList>
                <DatedOperatingLeg>
                    <Arrival>
                        <AircraftScheduledDateTime>2025-10-19T11:35:00</AircraftScheduledDateTime>
                        <IATA_LocationCode>AGX</IATA_LocationCode>
                    </Arrival>
                    <CarrierAircraftType>
                        <CarrierAircraftTypeCode>ATR-ATR</CarrierAircraftTypeCode>
                    </CarrierAircraftType>
                    <DatedOperatingLegID>seg1518674484-leg0</DatedOperatingLegID>
                    <Dep>
                        <AircraftScheduledDateTime>2025-10-19T10:10:00</AircraftScheduledDateTime>
                        <IATA_LocationCode>COK</IATA_LocationCode>
                    </Dep>
                </DatedOperatingLeg>
            </DatedOperatingLegList>
            <DatedOperatingSegmentList>
                <DatedOperatingSegment>
                    <CarrierDesigCode>6E</CarrierDesigCode>
                    <DatedOperatingLegRefID>seg1518674484-leg0</DatedOperatingLegRefID>
                    <DatedOperatingSegmentId>Opr-seg1518674484</DatedOperatingSegmentId>
                    <Duration>PT1H25M</Duration>
                    <OperatingCarrierFlightNumberText>7005</OperatingCarrierFlightNumberText>
                </DatedOperatingSegment>
            </DatedOperatingSegmentList>
            <PaxJourneyList>
                <PaxJourney>
                    <PaxJourneyID>fl1518674484</PaxJourneyID>
                    <PaxSegmentRefID>seg1518674484</PaxSegmentRefID>
                </PaxJourney>
            </PaxJourneyList>
            <PaxList>
                <Pax>
                    <CitizenshipCountryCode>IN</CitizenshipCountryCode>
                    <ContactInfoRefID>con-1</ContactInfoRefID>
                    <Individual>
                        <Birthdate>1993-07-08</Birthdate>
                        <GenderCode>M</GenderCode>
                        <GivenName>Jay</GivenName>
                        <IndividualID>A653159666</IndividualID>
                        <Surname>Sharma</Surname>
                        <TitleName>MR</TitleName>
                    </Individual>
                    <PaxID>A653159666</PaxID>
                    <PTC>ADT</PTC>
                    <ResidenceCountryCode>IN</ResidenceCountryCode>
                </Pax>
            </PaxList>
            <PaxSegmentList>
                <PaxSegment>
                    <CabinTypeAssociationChoice>
                        <SegmentCabinType>
                            <CabinTypeCode>5</CabinTypeCode>
                            <CabinTypeName>Economy</CabinTypeName>
                        </SegmentCabinType>
                    </CabinTypeAssociationChoice>
                    <DatedMarketingSegmentRefId>Mkt-seg1518674484</DatedMarketingSegmentRefId>
                    <PaxSegmentID>seg1518674484</PaxSegmentID>
                </PaxSegment>
            </PaxSegmentList>
            <PriceClassList>
                <PriceClass>
                    <Code>R</Code>
                    <Desc>
                        <DescText>Combinable with Regular, Return Special, Family, Tactical, or Sale Fares</DescText>
                    </Desc>
                    <FareBasisCode>A0IP</FareBasisCode>
                    <Name>Regular Fare</Name>
                    <PriceClassID>pc710786564</PriceClassID>
                </PriceClass>
            </PriceClassList>
            <ServiceDefinitionList>
                <ServiceDefinition>
                    <Desc>
                        <DescText>Free</DescText>
                        <MarkupStyleText>FreeOrChargeable</MarkupStyleText>
                    </Desc>
                    <Name>Domestic Regular New</Name>
                    <OwnerCode>6E</OwnerCode>
                    <RFIC>C</RFIC>
                    <RFISC>04B</RFISC>
                    <ServiceCode>bag01719913658</ServiceCode>
                    <ServiceDefinitionAssociation>
                        <BaggageAllowanceRef>
                            <BaggageAllowanceRefID>bag01719913658</BaggageAllowanceRefID>
                        </BaggageAllowanceRef>
                    </ServiceDefinitionAssociation>
                    <ServiceDefinitionID>def001741362342</ServiceDefinitionID>
                </ServiceDefinition>
            </ServiceDefinitionList>
        </DataLists>
        <Order xmlns="http://www.iata.org/IATA/2015/EASD/00/IATA_OffersAndOrdersCommonTypes">
            <OrderID>QP4KTY</OrderID>
            <OrderItem>
                <FareDetail>
                    <FareComponent>
                        <CabinType>
                            <CabinTypeCode>5</CabinTypeCode>
                            <CabinTypeName>Economy</CabinTypeName>
                        </CabinType>
                        <FareBasisCode>A0IP</FareBasisCode>
                        <FareRule>
                            <Remark>
                                <RemarkText>IndiGo Fares Terms & Conditions


Regular / Promo - One Way retail


Baggage Conditions
Check-in Baggage Allowance: 15 kg for Domestic sectors and 20 kg for International Sectors except 30 Kg for Kuwait, Abu Dhabi, Dubai, Muscat, Damam, Sharjah, Doha, Istanbul and Codeshare destinations; and 25 kg for Jeddah + 5L Zamzam water (only for flights from Jeddah to India)
Hand Baggage Allowance: 7 Kg on IndiGo Operations and 8 Kg on 6E-TK Codeshares. (Including ladies bag and laptop bag.)
</RemarkText>
                            </Remark>
                        </FareRule>
                        <PaxSegmentRefID>seg1518674484</PaxSegmentRefID>
                        <PriceClassRefID>pc710786564</PriceClassRefID>
                        <RBD>
                            <RBD_Code>A</RBD_Code>
                        </RBD>
                    </FareComponent>
                    <PaxRefID>A653159666</PaxRefID>
                    <Price>
                        <BaseAmount CurCode="INR">8011.00</BaseAmount>
                        <Fee>
                            <Amount CurCode="INR">50.00</Amount>
                            <DescText>Cute Charge</DescText>
                            <DesigText>PHF</DesigText>
                        </Fee>
                        <Fee>
                            <Amount CurCode="INR">50.00</Amount>
                            <DescText>Regional Connectivity Charge</DescText>
                            <DesigText>RCF</DesigText>
                        </Fee>
                        <Fee>
                            <Amount CurCode="INR">236.00</Amount>
                            <DescText>Aviation Security Fee</DescText>
                            <DesigText>ASF</DesigText>
                        </Fee>
                        <Fee>
                            <Amount CurCode="INR">319.00</Amount>
                            <DescText>User Development fee</DescText>
                            <DesigText>UDF</DesigText>
                        </Fee>
                        <TaxSummary>
                            <Tax>
                                <Amount CurCode="INR">280.00</Amount>
                                <DescText>Transaction Fee</DescText>
                                <FiledTaxCode>TF</FiledTaxCode>
                                <TaxCode>TF</TaxCode>
                                <TaxName>Transaction Fee</TaxName>
                            </Tax>
                            ...
Error Description Resolution
OR4005 Invalid format in OrderRetrieveRQ (commonly due to missing order id). Ensure the Order ID was returned from a prior OrderViewRS, OrderCreateRS, or OrderListRS.
OR4004 Failed to retrieve valid fare type codes setting. Provide Order ID or Offer details and time of the request for troubleshooting .
OR4003 Change of Origin and Destination is not permitted. Keep origin and destination the same as in the original order.
OR4002 Cancellation must apply to all travelers. Ensure all travelers (PAX references) from the order are included in the OrderCancelRQ.

Flow of Order Retrieve

Below is the Order Retrieve shopping flow diagram.

AccessToken
↓
OrderRetrieve
↓
End

Need help? Check FAQs

What is an NDC Order Retrieve?

Order Retrieve is an NDC API service that allows an airline or travel agent to fetch details of a previously created order (e.g., booking, ticket). This can include flight segments, passenger information, payment status, and more.

Can I modify an order after retrieving it?

No. Order Retrieve is read-only. To change an order, you must use Order Change or Order Cancel APIs.

Is Order Retrieve the same as PNR retrieval in traditional GDS?

Conceptually, yes. But technically, NDC's Order Retrieve is part of a new, XML or JSON-based workflow that follows IATA standards, unlike the legacy PNR formats used in GDS systems.