Order Create

IATA_OrderCreateRQ converts an Offer to an Order. An authenticated communication is required. Once an OfferPrice offer has been returned in IATA_OfferPriceRS, the seller may construct an IATA_OrderCreateRQ that contains the priced offer by specifying the following:

a. OfferID.

b. List of all mandatory OfferItemIDs.

  • i. Each OfferItemID should have a list of services with associated passengers in the PaxRefID field.
  • ii. Offer Item IDs for seat or ancillaries from Offer Price if any were provided.

c. Detailed passengers with individual information should be populated in the DataLists PaxList.

d. Optional Identity Document can be populated for each passenger.

e. Point of sale details to associate with order creation.

f. Option to include payments to complete the Order. See section on handling payments for more details.

NDC Gateway responds with an IATA_OrderViewRS which contains the created order. The created order includes details such as the OrderID, selected services, balance due, payment information and status. If an error is encountered during order creation it will also be returned in the IATA_OrderViewRS

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

POST: v21.3/OrderCreate

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

Below is a sample XML request of the Aviation APIs:

<IATA_OrderCreateRQ 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>
                <Name>6E Travel</Name>
                <OrgID>{{OrgID}}</OrgID>
            </ParticipatingOrg>
        </DistributionChainLink>
        <DistributionChainLink xmlns="http://www.iata.org/IATA/2015/EASD/00/IATA_OffersAndOrdersCommonTypes">
            <Ordinal>2</Ordinal>
            <OrgRole>Carrier</OrgRole>
            <ParticipatingOrg>
                <OrgID>6E</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>
        <CreateOrder xmlns="http://www.iata.org/IATA/2015/EASD/00/IATA_OffersAndOrdersCommonTypes">
            <AcceptSelectedQuotedOfferList>
                <SelectedPricedOffer>
                    <OfferRefID>sid-fe7f7c9e-7804-42ee-9249-85b89afc5a05</OfferRefID>
                    <OwnerCode>6E</OwnerCode>
                    <SelectedOfferItem>
                        <OfferItemRefID>sid-fe7f7c9e-7804-42ee-9249-85b89afc5a05-1</OfferItemRefID>
                        <PaxRefID>ADT0</PaxRefID>
                    </SelectedOfferItem>
                    <SelectedOfferItem>
                        <OfferItemRefID>sid-8800a2a0-f506-4461-8f82-2f8a467486dd-2</OfferItemRefID>
                        <PaxRefID>ADT0</PaxRefID>
                    </SelectedOfferItem>
                </SelectedPricedOffer>
            </AcceptSelectedQuotedOfferList>
        </CreateOrder>
        <DataLists xmlns="http://www.iata.org/IATA/2015/EASD/00/IATA_OffersAndOrdersCommonTypes">
            <ContactInfoList>
                <ContactInfo>
                    <ContactInfoID>Contact-1</ContactInfoID>
                    <ContactPurposeText>NTF</ContactPurposeText>
                    <EmailAddress>
                        <EmailAddressText>rakesh.kumar20@goindigo.in</EmailAddressText>
                    </EmailAddress>
                    <Phone>
                        <!-- <areaCodeNumber>011</areaCodeNumber><contactTypeText>Home</contactTypeText><countryDialingCode>91</countryDialingCode><extensionNumber>789</extensionNumber> -->
                        <PhoneNumber>8978987898</PhoneNumber>
                    </Phone>
                    <PostalAddress>
                        <CityName>CIT</CityName>
                        <CountryCode>IN</CountryCode>
                        <PostalCode>122001</PostalCode>
                        <StreetText>143 Street</StreetText>
                    </PostalAddress>
                </ContactInfo>
            </ContactInfoList>
            <PaxList>
                <Pax>
                    <CitizenshipCountryCode>IN</CitizenshipCountryCode>
                    <ContactInfoRefID>Contact-1</ContactInfoRefID>
                    <!-- <IdentityDoc><Birthdate>1993-07-08</Birthdate><CitizenshipCountryCode>IN</CitizenshipCountryCode><ExpiryDate>2028-06-29</ExpiryDate><GenderCode>M</GenderCode><GivenName>Rakesh</GivenName><IdentityDocID>DOC1</IdentityDocID><IdentityDocTypeCode>PT</IdentityDocTypeCode><IssueDate>2018-07-02</IssueDate><IssuingCountryCode>IN</IssuingCountryCode><MiddleName>Kumar</MiddleName><ResidenceCountryCode>IN</ResidenceCountryCode><Surname>Sharma</Surname><TitleName>Mr</TitleName></IdentityDoc> -->
                    <Individual>
                        <Birthdate>1993-07-08</Birthdate>
                        <GenderCode>M</GenderCode>
                        <GivenName>Jay</GivenName>
                        <Surname>Sharma</Surname>
                        <TitleName>Mr</TitleName>
                    </Individual>
                    <!-- <LoyaltyProgramAccount><AccountNumber>AB12CD34EF</AccountNumber><LoyaltyProgram><Carrier><AirlineDesigCode>6E</AirlineDesigCode></Carrier>
                        </LoyaltyProgram>
                    </LoyaltyProgramAccount> -->
                    <PaxID>ADT0</PaxID>
                    <PTC>ADT</PTC>
                    <ResidenceCountryCode>IN</ResidenceCountryCode>
                </Pax>
                <Pax>
                    <CitizenshipCountryCode>IN</CitizenshipCountryCode>
                    <ContactInfoRefID>Contact-1</ContactInfoRefID>
                    <Individual>
                        <Birthdate>1993-07-08</Birthdate>
                        <GenderCode>M</GenderCode>
                        <GivenName>Rahul</GivenName>
                        <Surname>Sharma</Surname>
                        <TitleName>Mr</TitleName>
                    </Individual>
                    <PaxID>ADT1</PaxID>
                    <PTC>ADT</PTC>
                    <ResidenceCountryCode>IN</ResidenceCountryCode>
                </Pax>
            </PaxList>
        </DataLists>
        <PaymentFunctions xmlns="http://www.iata.org/IATA/2015/EASD/00/IATA_OffersAndOrdersCommonTypes">
            <PaymentProcessingDetails>
                <Amount CurCode='INR'>9366.00</Amount>
                <PaymentMethod>
                    <SettlementPlan>
                        <IATA_Number>1</IATA_Number>
                        <PaymentTypeCode>AGT</PaymentTypeCode>
                    </SettlementPlan>
                </PaymentMethod>
            </PaymentProcessingDetails>
        </PaymentFunctions>
    </Request>
</IATA_OrderCreateRQ>

Order View 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>
                    <Remark>
                        <RemarkText>ADT0</RemarkText>
                    </Remark>
                    <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>
                                ...
Error Description Resolution
OF4020 Error encountered on booking commit. Verify that all required booking details are complete and accurate.
OF4021 Agent is not allowed to over pay. Confirm that the payment amount matches the expected value for the booking.
OF4022 Agent is not allowed to under pay. Ensure that the payment amount meets the minimum required value for the booking.
AS4004 Unable to Sell Infant Pax. Check if the booking system supports infant passengers for the selected flight or service.

FLow of Order Create

Below is the Order Create flow diagram.

AuthToken
↓
AirShopping
↓
OfferPrice
↓
OrderCreate
↓
End

Need help? Check FAQs

Can I add ancillaries during order creation?

Yes, if the airline supports it. Ancillaries (e.g., extra baggage, seat selection) can be included in the same OrderCreateRQ or added later via ServiceList and OrderChange.

Is payment always required at the time of order creation?

It depends on the airline. Some allow delayed payment or payment via credit shell, while others require immediate payment as part of the OrderCreate process.

How do I know if the order was created successfully?

A successful OrderCreateRS response will include: An OrderID, Passenger(s) and flight segment info, Payment confirmation.