NDC API V_17_2

Introduction

The Order retrive allows to retrive PNR details.

Input

Order ID / PNR

Http Headers

Key	Value	Required
Content-Type	application/xml	Yes
Accept	/	Yes
Authorization	Bearer {{access_token}}	Yes
Content-Length	<calculated when request is sent>	Yes
Host	<calculated when request is sent>	Yes
User-Agent	PostmanRuntime/7.30.0	Yes
Accept-Encoding	gzip, deflate, br	Yes
Connection	Keep-alive	Yes
DeviceID	String	Yes

Sequence

Endpoints

Test	Live
https://aks-cluster-test.ethiopianairlines.com	https://ndc.ethiopianairlines.com

OrderRetrieve Request

		     
			<Document>
				<Name>ETHIOPIAN AIRLINES NDC </Name>
				<ReferenceVersion>1.0</ReferenceVersion>
		   </Document>

Request	Root node of the request schema
Document
Name	Document Name
ReferenceVersion	Reference Version

		     
			    <Party>
        <Sender>
            <TravelAgencySender>
                <Name>Ethiopianairlines TravelAgency</Name>
                <IATA_Number>12121212</IATA_Number>
                <AgencyID Owner="ET">A345345435</AgencyID>
            </TravelAgencySender>
        </Sender>
        <Participants>
            <Participant>
                <AggregatorParticipant SequenceNumber="1">
                    <Name>AAAIT PLC</Name>
                    <AggregatorID>88888888</AggregatorID>
                </AggregatorParticipant>
            </Participant>
        </Participants>
        <Recipient>
            <ORA_Recipient>
                <AirlineID>ET</AirlineID>
                <Name>ETHIOPIAN AIRLINES</Name>
            </ORA_Recipient>
        </Recipient>
    </Party>

Request	Root node of the request schema
Party	Aggregator and OTA information
Sender
TravelAgencySender	Travel agency involved in the request
Name	Travel agency’s official name
IATA_Number	Travel agency’s IATA number
AgencyID	Travel agency’s Agency ID
Participants	List of aggregators involved in the request
Participant
AggregatorParticipant
@SequenceNumber	Unique position in the list e.g. 1, 2, 3
Name	Aggregator’s official name
AggregatorID	Aggregator’s ID
Recipient
ORA_Recipient	Offer responsible airline information
AirlineID	IATA Airline code e.g. ET
Name	Ethiopian Airlines

		     
			 <Query>
        <Filters>
            <OrderID Owner="ET">{{OrderId}}</OrderID>
        </Filters>
 </Query>

Request	Root node of the request schema
Query
Filters
OwnerID	ET
OrderID	PTQTPN

OrderView Response

		     
			<Document>
				<Name>ETHIOPIAN AIRLINES NDC </Name>
				<ReferenceVersion>1.0</ReferenceVersion>
		   </Document>

Request	Root node of the request schema
Document
Name	Document Name
ReferenceVersion	Reference Version

		     
			Price breakdown is now available on the order item id level 
<Order OrderID="PTQTPN" Owner="ET">
            <BookingReferences>
                <BookingReference>
                    <ID>PTQTPN</ID>
                    <AirlineID Name="ETHIOPIAN AIRLINES">ET</AirlineID>
                </BookingReference>
            </BookingReferences>
            <TotalOrderPrice>
                <SimpleCurrencyPrice Code="USD">7256.14</SimpleCurrencyPrice>
            </TotalOrderPrice>
            <TimeLimits>
                <PaymentTimeLimit Timestamp="2023-01-16T08:34:00" />
            </TimeLimits>
            <OrderItems>
                <OrderItem OrderItemID="ORDERITEM001" Owner="ET">
                    <PriceDetail>
                        <TotalAmount>
                            <SimpleCurrencyPrice Code="USD">463.40</SimpleCurrencyPrice>
                        </TotalAmount>
                        <BaseAmount Code="USD">336.00</BaseAmount>
                        <Surcharges>
                            <Surcharge>
                                <Total Code="USD">0</Total>
                            </Surcharge>
                        </Surcharges>
                        <Taxes>
                            <Total Code="USD">127.40</Total>
                        </Taxes>
                    </PriceDetail>
                    <Service ServiceID="SV_1_001">
                        <PassengerRef>PAX001 </PassengerRef>
                        <ServiceRef>SV_ES</ServiceRef>
                        <SegmentRef>SEG_ADDDXB_001</SegmentRef>
                    </Service>
                </OrderItem>
                <OrderItem OrderItemID="ORDERITEM002" Owner="ET">
                    <PriceDetail>
                        <TotalAmount>
                            <SimpleCurrencyPrice Code="USD">379.40</SimpleCurrencyPrice>
                        </TotalAmount>
                        <BaseAmount Code="USD">252.00</BaseAmount>
                        <Surcharges>
                            <Surcharge>
                                <Total Code="USD">0</Total>
                            </Surcharge>
                        </Surcharges>
                        <Taxes>
                            <Total Code="USD">127.40</Total>
                        </Taxes>
                    </PriceDetail>
                    <Service ServiceID="SV_2_002">
                        <PassengerRef>PAX002 </PassengerRef>
                        <ServiceRef>SV_ES</ServiceRef>
                        <SegmentRef>SEG_ADDDXB_002</SegmentRef>
                    </Service>
                </OrderItem>
                <OrderItem OrderItemID="ORDERITEM003" Owner="ET">
                    <PriceDetail>
                        <TotalAmount>
                            <SimpleCurrencyPrice Code="USD">48.00</SimpleCurrencyPrice>
                        </TotalAmount>
                        <BaseAmount Code="USD">34.00</BaseAmount>
                        <Surcharges>
                            <Surcharge>
                                <Total Code="USD">0</Total>
                            </Surcharge>
                        </Surcharges>
                        <Taxes>
                            <Total Code="USD">14.00</Total>
                        </Taxes>
                    </PriceDetail>
                    <Service ServiceID="SV_3_003">
                        <PassengerRef>PAX003 </PassengerRef>
                        <ServiceRef>SV_ES</ServiceRef>
                        <SegmentRef>SEG_ADDDXB_003</SegmentRef>
                    </Service>
                </OrderItem>
            </OrderItems>
        </Order>

Request	Root node of the request schema
Response
Order
@OrderID	PNR e.g. YTDFRA
@Owner	ORA
BookingReferences
BookingReference
ID	PNR e.g. YTDFRA
AirlineID	ET
@Name	Ethiopian Airlines
TotalOrderPrice	Total ticket price including taxes
SimpleCurrencyPrice	Total order price e.g. 107208
@Code	Currency code e.g. USD, GBP, EUR
BaseAmount	Base fare value
@Code	Currency code
Taxes
Total	Tax value
@Code	Currency code
Service	Service per segment per passenger
@ServiceID	Service per segment per passenger
PassengerRef	Passenger entitled to service
SegmentRef	Flight segment associated to service

		     
			       <DataLists>
            <PassengerList>
                <Passenger PassengerID="PAX001">
                    <PTC>ADT</PTC>
                    <Individual>
                        <Birthdate>1988-06-10</Birthdate>
                        <Gender>Female</Gender>
                        <NameTitle>MRS</NameTitle>
                        <GivenName>Jane</GivenName>
                        <Surname>Smith</Surname>
                    </Individual>
                    <LoyaltyProgramAccount>
                        <AccountNumber />
                    </LoyaltyProgramAccount>
                    <IdentityDocument>
                        <IdentityDocumentNumber>543000123</IdentityDocumentNumber>
                        <IdentityDocumentType>F</IdentityDocumentType>
                        <IssuingCountryCode>US</IssuingCountryCode>
                        <CitizenshipCountryCode>US</CitizenshipCountryCode>
                        <IssueDate>2017-01-17</IssueDate>
                        <ExpiryDate>2022-01-16</ExpiryDate>
                        <Birthdate>1988-06-10</Birthdate>
                        <Birthplace>US</Birthplace>
                    </IdentityDocument>
                    <ContactInfoRef>CTC01</ContactInfoRef>
                </Passenger>
                <Passenger PassengerID="PAX002">
                    <PTC>ADT</PTC>
                    <Individual>
                        <Birthdate>2019-06-10</Birthdate>
                        <Gender>Female</Gender>
                        <NameTitle>MRS</NameTitle>
                        <GivenName>sawi</GivenName>
                        <Surname>sawale</Surname>
                    </Individual>
                    <LoyaltyProgramAccount>
                        <AccountNumber />
                    </LoyaltyProgramAccount>
                    <IdentityDocument>
                        <IdentityDocumentNumber>543000123</IdentityDocumentNumber>
                        <IdentityDocumentType>F</IdentityDocumentType>
                        <IssuingCountryCode>US</IssuingCountryCode>
                        <CitizenshipCountryCode>US</CitizenshipCountryCode>
                        <IssueDate>2021-01-17</IssueDate>
                        <ExpiryDate>2022-01-16</ExpiryDate>
                        <Birthdate>2019-06-10</Birthdate>
                        <Birthplace>US</Birthplace>
                    </IdentityDocument>
                    <ContactInfoRef>CTC01</ContactInfoRef>
                </Passenger>
            </PassengerList>
            <BagDisclosureList />
            <BaggageAllowanceList />
            <FlightSegmentList>
                <FlightSegment SegmentKey="SEG_ADDIAD_001">
                    <Departure>
                        <AirportCode>ADD</AirportCode>
                        <Date>2023-03-20</Date>
                        <Time>09:00</Time>
                    </Departure>
                    <Arrival>
                        <AirportCode>IAD</AirportCode>
                        <Date>2023-03-20</Date>
                        <Time>19:25</Time>
                        <Terminal>
                            <Name>2</Name>
                        </Terminal>
                    </Arrival>
                    <MarketingCarrier>
                        <AirlineID>ET</AirlineID>
                        <FlightNumber>516</FlightNumber>
                    </MarketingCarrier>
                    <OperatingCarrier>
                        <AirlineID>ET</AirlineID>
                        <FlightNumber>516</FlightNumber>
                    </OperatingCarrier>
                    <Equipment>
                        <AircraftCode>788</AircraftCode>
                    </Equipment>
                    <ClassOfService>
                        <Code>D</Code>
                        <MarketingName>BUSINESS</MarketingName>
                        <FareBasisCode>DEYJ0WET</FareBasisCode>
                    </ClassOfService>
                    <FlightDetail>
                        <FlightDistance>
                            <Value>7929</Value>
                            <UOM>Miles</UOM>
                        </FlightDistance>
                        <FlightDuration>
                            <Value>PT17H25M</Value>
                        </FlightDuration>
                    </FlightDetail>
                </FlightSegment>
            </FlightSegmentList>
            <FlightList>
                <Flight FlightKey="FLT001">
                    <SegmentReferences>SEG_ADDIAD_001</SegmentReferences>
                </Flight>
            </FlightList>
            <OriginDestinationList>
                <OriginDestination>
                    <DepartureCode>ADD</DepartureCode>
                    <ArrivalCode>IAD</ArrivalCode>
                    <FlightReferences>FLT001</FlightReferences>
                </OriginDestination>
            </OriginDestinationList>
        </DataLists>

Request	Root node of the request schema
DataLists
PassengerList
Passenger
@PassengerID	Unique passenger identifier e.g. PAX001
PTC	Passenger type e.g. ADT, CHD
FlightSegmentList
FlightSegment	Flight segment information
@SegmentKey	Unique segment identification
Departure
AirportCode	Departure airport e.g. ADD
Date	Departure date. Format YYYY-MM-DD
Time	Departure time. Format HH:MM
Terminal	Total price including taxes
Name	Departure Airport Name
Arrival
AirportCode	Arrival airport e.g. LOS
Date	Arrival date. Format YYYY-MM-DD
Time	Arrival time. Format HH:MM
Terminal
Name	Arrival Airport name
MarketingCarrier	Airline selling the ticket
AirlineID	IATA airline code
FlightNumber	Flight number
OperatingCarrier	Airline operating the flight
AirlineID	IATA airline code
FlightNumber	Flight Number
Equipment
AircraftCode	Type of aircraft
ClassOfService
Code
MarketingName	Default segment brand
FareBasisCode
FlightDetail
FlightDistance
Value	Flight distance value
UOM	Unit Of Measurement
FlightDuration
Value	PT4H10M implies 4 hours and 10 minutes
FlightList	List of flights
Flight	Single flight with one or more segments
@FlightKey	Unique flight identification
SegmentReferences	Segments associated with flight
OnPoint	Origin city
OffPoint	Destination city
OriginDestinationList	List of flight origin and destination
OriginDestination
DepartureCode	Departure city
@UOM	Unit of measurement
ArrivalCode	Arrival city
@UOM	Unit of measurement
FlightReferences	Flights associated to this origin destination
ServiceDefinitionList
@ServiceDefinitionID	Unique Service Def ID
Name	Brand name of service e.g. EP
Descriptions	List of description text
Description	e.g. ECONOMY PROMO

XML Sample

Request and Response	Sample OrderRetrieve XML
OrderRetrieve Request	Click to download
OrderRetrieve Response	Click to download
Multi pax OrderRetrieve Request	Click to download
Multi pax OrderRetrieve Response	Click to download

Erorrs Response Description

Error responses

Erorr Code	Error Code Text
400	Page not found
200	Success response
0	Error

Connect to Ethiopian NDC platform today!

NDC API V_17_2

Airshopping

OfferPrice

OrderCreate

Order Retrieve

AirDocIssue (Ticketing)

Order Reshop

Order Change

Refund Order Reshop

Refund Order cancel

Order Retrieve

Order Retrieve

Void Ticket

Order Retrieve

Air Cancel

Order Rule

Add/Update Loyalty Number

Order Reprice

Add/update identity doc

Seat Availability

Seat Select

Service Availability

Service Select

Meal Availabilities

Meal Selects

Introduction

About us

Terms and Conditions

Ethiopian App

Social Media

Subscribe

Best Airline in Africa for seven years in a row

Best Business Class in Africa for six years in a row

Best Economy Class in Africa for six years in a row

Best Economy Class OnBoard Catering in Africa

Connect to Ethiopian NDC platform today!

NDC API V_17_2

Booking

Order Exchange

Order Refund

Order Void

Order Cancel

Order Manage

Manage Seat

Special service

Meal Manage

FAQs

Support

Introduction

XML Sample

XML Sample

XML Sample

XML Sample

XML Sample - update available

XML Sample

Ethiopian App

Social Media

Subscribe

Best Economy Class in Africa for six years in a row

Best Economy Class OnBoard Catering in Africa