NDC API V_17_2

Introduction

The AirShopping allows you to search for a flight from one origin to one destination or from an initial origin to multiple cities.

Input

Origin and destination (departure airport, arrival airport)
Flight date, cabin type
Passenger details can also contain Name & FQTV details, if applicable.
Currency, the currency override allows to pass specific currency that you are allowed to sell on a specific origin other way the default currency will be applicable

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

Airshopping 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

		     
			    <CoreQuery>
        <OriginDestinations>
            <OriginDestination>
                <Departure>
                    <AirportCode>ADD</AirportCode>
                    <Date>2022-12-20</Date>
                </Departure>
                <Arrival>
                    <AirportCode>CAI</AirportCode>
                </Arrival>
            </OriginDestination>
            
        </OriginDestinations>
    </CoreQuery>

Request	Root node of the request schema
CoreQuery
OriginDestinations	List of origin and destination
OrginDestination
Departure
AirportCode	Airport 3 letter code e.g. DXB
Date	Departure date
Arrival
AirportCode	Airport 3 letter code e.g. LHR

		     
			   <Preference>
        <CabinPreferences>
            <CabinType>
                <Code>3</Code>
            </CabinType>
        </CabinPreferences>
    </Preference>

Request	Root node of the request schema
Preference	Search returns all cabin if preference is not specified
CabinPreferences
CabinType
Code	0 – PremiumFirst 1 – First 2 – PremiumBusiness 3 – Business 4 – PremiumEconomy 5 – Economy

		     
			    <Parameters>
        <Pricing>
            <OverrideCurrency>ETB</OverrideCurrency>
        </Pricing>
    </Parameters>

Request	Root node of the request schema
Parameters	override currency
Pricing
OverrideCurrency	Currency code e.g. ETB

		     
			            <Passenger PassengerID="PX001">
                <PTC>ADT</PTC>
                <Individual>
                    <NameTitle>MR</NameTitle>
                    <GivenName>Jane</GivenName>
                    <Surname>Smith</Surname>
                </Individual>
                <LoyaltyProgramAccount>
                    <AccountNumber>1234525525</AccountNumber>
                </LoyaltyProgramAccount>
            </Passenger>

Request	Root node of the request schema
Passenger
@PassengerID	Unique passenger identifier e.g. PAX001
PTC	Passenger type e.g. ADT, CHD, INF
LoyaltyProgramAccount
AccountNumber	Passenger loyalty number

Airshopping 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

		     
			    <ShoppingResponseID>
        <ResponseID>LWJQNMJOZK2ZMSB</ResponseID>
    </ShoppingResponseID>

Request	Root node of the request schema
Shopping Response
ResponseID	Response ID of the shopping request e.g. LWJQNMJOZK2ZMSB

		     
			The new update on the airshopping response indicate that price breakdown per passenger type is available per the OfferItemID. 
The response below is for 1 adult, 1 child and 1 infant. Each offerID contain all the three passenger types and price breakdown is found at OfferItemID.
To proceed to offer pricing you should have both a single offerID and OfferItemID of each passengers
    <OffersGroup>
        <AirlineOffers>
            <Offer OfferID="OFFER001" Owner="ET">
                <TimeLimits>
                    <OfferExpiration Timestamp="2023-04-17T13:18:40.8777761Z" />
                </TimeLimits>
                <TotalPrice>
                    <SimpleCurrencyPrice Code="USD">890.80</SimpleCurrencyPrice>
                </TotalPrice>
                <OfferItem OfferItemID="OFFERITEM-6478847636">
                    <TotalPriceDetail>
                        <TotalAmount>
                            <SimpleCurrencyPrice Code="USD">463.40</SimpleCurrencyPrice>
                        </TotalAmount>
                    </TotalPriceDetail>
                    <Service ServiceID="SV_FLT001_PX001">
                        <PassengerRefs>PX001</PassengerRefs>
                        <ServiceRef>SD_ES</ServiceRef>
                        <FlightRefs>FLT001</FlightRefs>
                    </Service>
                    <FareDetail>
                        <PassengerRefs>PX001</PassengerRefs>
                        <Price>
                            <TotalAmount>
                                <SimpleCurrencyPrice Code="USD">463.40</SimpleCurrencyPrice>
                            </TotalAmount>
                            <BaseAmount xsi:type="SimpleCurrencyPriceType" Code="USD">336.00</BaseAmount>
                            <Taxes>
                                <Total Code="USD">127.40</Total>
                            </Taxes>
                        </Price>
                    </FareDetail>
                </OfferItem>
                <OfferItem OfferItemID="OFFERITEM-2030111990">
                    <TotalPriceDetail>
                        <TotalAmount>
                            <SimpleCurrencyPrice Code="USD">379.40</SimpleCurrencyPrice>
                        </TotalAmount>
                    </TotalPriceDetail>
                    <Service ServiceID="SV_FLT001_PX002">
                        <PassengerRefs>PX002</PassengerRefs>
                        <ServiceRef>SD_ES</ServiceRef>
                        <FlightRefs>FLT001</FlightRefs>
                    </Service>
                    <FareDetail>
                        <PassengerRefs></PassengerRefs>
                        <Price>
                            <TotalAmount>
                                <SimpleCurrencyPrice Code="USD">379.40</SimpleCurrencyPrice>
                            </TotalAmount>
                            <BaseAmount xsi:type="SimpleCurrencyPriceType" Code="USD">252.00</BaseAmount>
                            <Taxes>
                                <Total Code="USD">127.40</Total>
                            </Taxes>
                        </Price>
                    </FareDetail>
                </OfferItem>
                <OfferItem OfferItemID="OFFERITEM-2880184804">
                    <TotalPriceDetail>
                        <TotalAmount>
                            <SimpleCurrencyPrice Code="USD">48.00</SimpleCurrencyPrice>
                        </TotalAmount>
                    </TotalPriceDetail>
                    <Service ServiceID="SV_FLT001_PX003">
                        <PassengerRefs>PX003</PassengerRefs>
                        <ServiceRef>SD_ES</ServiceRef>
                        <FlightRefs>FLT001</FlightRefs>
                    </Service>
                    <FareDetail>
                        <PassengerRefs>PX003</PassengerRefs>
                        <Price>
                            <TotalAmount>
                                <SimpleCurrencyPrice Code="USD">48.00</SimpleCurrencyPrice>
                            </TotalAmount>
                            <BaseAmount xsi:type="SimpleCurrencyPriceType" Code="USD">34.00</BaseAmount>
                            <Taxes>
                                <Total Code="USD">14.00</Total>
                            </Taxes>
                        </Price>
                    </FareDetail>
                </OfferItem>
            </Offer>
       </AirlineOffers>
  </OffersGroup>

Request	Root node of the request schema
OffersGroup	Offers collection
AirlineOffers	List of airline offers
Offer	Specific flight with brands
@OfferID	Unique offer identification
@Owner	ORA
TimeLimits	Departure date
OfferExpiration
@Timestamp	Offer expiry time in ISO standard
OfferItem	Specific brand on the flight
@OfferItemID	Specific brand and price per passenger type
TotalPriceDetail
TotalAmount
SimpleCurrencyPrice	Total price including taxes
@Code	Currency code
BaseAmount	Base fare value
@Code	Currency code
Taxes
Total	Tax value
@Code	Currency code
Service
@ServiceID	Unique service identification
PassengerRefs	Passengers entitled to service
ServiceRef	Ref to Service Definition
ServiceDefinitionRef	Flight associated to service

		     
			<DataLists>
        <PassengerList>
            <Passenger PassengerID="PAX001">
                <PTC>ADT</PTC>
            </Passenger>
        </PassengerList>
        <FlightSegmentList>
            <FlightSegment SegmentKey="SEG_EBBADD_001">
                <Departure>
                    <AirportCode>EBB</AirportCode>
                    <Date>2023-03-20</Date>
                    <Time>02:45</Time>
                </Departure>
                <Arrival>
                    <AirportCode>ADD</AirportCode>
                    <Date>2023-03-20</Date>
                    <Time>04:55</Time>
                    <Terminal />
                </Arrival>
                <MarketingCarrier>
                    <AirlineID>ET</AirlineID>
                    <FlightNumber>339</FlightNumber>
                </MarketingCarrier>
                <OperatingCarrier>
                    <AirlineID>ET</AirlineID>
                    <FlightNumber>339</FlightNumber>
                </OperatingCarrier>
                <Equipment>
                    <AircraftCode>738</AircraftCode>
                </Equipment>
                <ClassOfService>
                    <Code>M</Code>
                    <MarketingName>ECONOMY</MarketingName>
                    <FareBasisCode>MEEUG</FareBasisCode>
                </ClassOfService>
                <FlightDetail>
                    <FlightDistance>
                        <Value>754</Value>
                        <UOM>Miles</UOM>
                    </FlightDistance>
                    <FlightDuration>
                        <Value>PT2H10M</Value>
                    </FlightDuration>
                </FlightDetail>
            </FlightSegment>
          </FlightSegmentList>
		 <FlightList>
		  <Flight FlightKey="FLT001">
                <SegmentReferences OnPoint="EBB" OffPoint="DSS">SEG_EBBADD_001 SEG_ADDDSS_002</SegmentReferences>
            </Flight>
            <Flight FlightKey="FLT002">
                <SegmentReferences OnPoint="DSS" OffPoint="EBB">SEG_DSSADD_003 SEG_ADDEBB_004</SegmentReferences>
            </Flight>
		</FlightList>
        <OriginDestinationList>
            <OriginDestination>
                <DepartureCode>EBB</DepartureCode>
                <ArrivalCode>DSS</ArrivalCode>
                <FlightReferences>FLT001 FLT003 FLT005 FLT007 FLT009 FLT011 FLT013 FLT015 FLT017 FLT019 FLT021 FLT023 FLT025 FLT027 FLT029 FLT031 FLT033 FLT035 FLT037 FLT039 FLT041 FLT043 FLT045 FLT047 FLT049 FLT051 FLT053 FLT055 FLT057 FLT059 FLT061 FLT063 FLT065 FLT067 FLT069 FLT071 FLT073 FLT075 FLT077 FLT079 FLT081 FLT083 FLT085 FLT087 FLT089 FLT091 FLT093 FLT095 FLT097 FLT099 FLT101 FLT103 FLT105 FLT107 FLT109 FLT111 FLT113 FLT115 FLT117 FLT119 FLT121 FLT123 FLT125 FLT127 FLT129 FLT131 FLT133 FLT135 FLT137 FLT139 FLT141 FLT143</FlightReferences>
            </OriginDestination>
		<ServiceDefinitionList>
            <ServiceDefinition ServiceDefinitionID="SD_ES" Owner="ET">
                <Name>ES</Name>
                <Descriptions>
                    <Description>
                        <Text>ECONOMY SEMI FLEX</Text>
                    </Description>
                </Descriptions>
            </ServiceDefinition>
	</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 Airshopping XML
Airshopping Request	Click to download
Airshoping Response	Click to download
Multi pax Airshopping Request	Click to download
Multi pax Airshoping Response	Click to download

Erorrs Response Description

AirShopping Error/Ineligibility Checks

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

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