Airports
Retrieves the complete details of one particular airport or list of airports and supports multiple languages whereever its applicable and available.
This resource contains the name, code and GPS location of each airport.
Request URIs
Code snippet: Call
GET /mds-references/airports[?LHoperated=1]
GET /mds-references/airports/{airportCode}[?lang={languageCode}]
GET /mds-references/airports[?limit={recordLimit}][&][offset={recordOffset}]
Variable | Description | Format |
---|---|---|
{airportCode} | Optionally return only this airport. | 3-letter IATA airport code, e.g. “TXL”. |
{languageCode} | Optionally return the airport name in only this language. |
2-letter ISO 639-1 language code, e.g. “EN”. |
{recordLimit} | Optionally sets the number of records returned. Defaults to 20, maximum is 100. | integer, e, g, 44 |
{recordOffset} | Optionally sets the number of records skipped when sorting response records alphabetically. Defaults to 0. |
integer, e.g. 123 |
LHoperated |
Optionally If set to 1, only locations with flights operated by Lufthansa will be returned. | boolean e.g. 0 |
group | Optionally restrict the results to locations with flights operated by group. | enum: {MilesAndMore,LHOperated,AllAirports} |
Request Examples
Code snippet: Call
GET /mds-references/airports
GET /mds-references/airports?LHoperated=1
GET /mds-references/airports/TXL
GET /mds-references/airports/TXL?lang=DE
GET /mds-references/airports?limit=44&offset=123
Response Structure Definition
Key | Description |
---|---|
AirportResource | Root element of airport response. |
.Airports | Container for airport elements. |
..Airport[] | Array of all available airports or one airport matching the request. |
...AirportCode | 3-letter IATA airport code, e.g. “TXL”. |
...Position | Physical location of an airport. This data section is optional and therefore not always present. |
....Coordinate | Container for coordinates. |
.....Latitude | Decimal latitude. Range: -90 (South Pole) to +90 (North Pole), e.g. “51.540”. |
.....Longitude | Decimal longitude. Range: -180 (West of Prime Meridian) to +180 (East of Prime Meridian). |
...CityCode |
3-letter IATA city code, e.g. “BER”. |
...CountryCode | 2-letter ISO 3166-1 country code, e.g. “DE”. |
...LocationType | “Airport”, “RailwayStation” or "BusStation". |
...Names | Container for airport names. |
....Name[] | Array: language specific full name of airport. |
@LanguageCode | 2-letter ISO 639-1 language code for the corresponding item. |
...UtcOffset | Hour offset of airport to UTC time zone |
...TimeZoneId | Time zone name airport is in |
.Meta | Container for meta links. |
..Link[] | Array: links to resource itself and other related resources. |
@Href | Link to actual a resource. |
@Rel | Specifying kind of link such as ‘self’ (link that returned this response), ‘alternate’ (link that points to another resource) or ‘related’ (link that points to related resource). |
Response Examples
<?xml version="1.0" encoding="UTF-8"?>
<AirportResource>
<Airports>
<Airport>
<AirportCode>TXL</AirportCode>
<Position>
<Coordinate>
<Latitude>52.5597</Latitude>
<Longitude>13.2878</Longitude>
</Coordinate>
</Position>
<CityCode>BER</CityCode>
<CountryCode>DE</CountryCode>
<LocationType>Airport</LocationType>
<Names>
<Name LanguageCode="EN">Berlin</Name>
</Names>
<UtcOffset>+01:00</UtcOffset>
<TimeZoneId>Europe/Berlin</TimeZoneId>
</Airport>
</Airports>
<Meta Version="1.0.0">
<Link Href="https://api.lufthansa.com/v1/mds-references/airports/TXL" Rel="self"/>
<Link Href="https://api.lufthansa.com/v1/references/cities/BER" Rel="related"/>
<Link Href="https://api.lufthansa.com/v1/references/countries/DE" Rel="related"/>
<Link Href="http://travelguide.lufthansa.com/de/de/berlin/TXL" Rel="alternate"/>
<Link Href="http://travelguide.lufthansa.com/de/en/berlin/TXL" Rel="alternate"/>
<Link Href="http://travelguide.lufthansa.com/de/cn/berlin/TXL" Rel="alternate"/>
<Link Href="http://travelguide.lufthansa.com/de/es/berlin/TXL" Rel="alternate"/>
<Link Href="http://travelguide.lufthansa.com/de/fr/berlin/TXL" Rel="alternate"/>
<Link Href="http://travelguide.lufthansa.com/de/it/berlino/TXL" Rel="alternate"/>
<Link Href="http://travelguide.lufthansa.com/de/pt/berlim/TXL" Rel="alternate"/>
</Meta>
</AirportResource>
<?xml version="1.0" encoding="UTF-8"?> <AirportResource> <Airports> <Airport> <AirportCode>AAA</AirportCode> <Position> <Coordinate> <Latitude>-17.3525</Latitude> <Longitude>-145.51</Longitude> </Coordinate> </Position> <CityCode>AAA</CityCode> <CountryCode>PF</CountryCode> <LocationType>Airport</LocationType> <Names> <Name LanguageCode="DE">Anaa</Name> <Name LanguageCode="EL">Αναά</Name> <Name LanguageCode="EN">Anaa</Name> <Name LanguageCode="ES">Anaa</Name> <Name LanguageCode="FR">Anaa</Name> <Name LanguageCode="IT">Anaa</Name> <Name LanguageCode="TR">Anaa</Name> </Names> <UtcOffset>-10:00</UtcOffset> <TimeZoneId>Pacific/Tahiti</TimeZoneId> </Airport> <Airport> <AirportCode>AAB</AirportCode> <Position> <Coordinate> <Latitude>-26.6911</Latitude> <Longitude>141.0472</Longitude> </Coordinate> </Position> <CityCode>AAB</CityCode> <CountryCode>AU</CountryCode> <LocationType>Airport</LocationType> <Names> <Name LanguageCode="DE">Arrabury</Name> <Name LanguageCode="EL">Αραμπέρι</Name> <Name LanguageCode="EN">Arrabury</Name> <Name LanguageCode="ES">Arrabury</Name> <Name LanguageCode="FR">Arrabury</Name> <Name LanguageCode="IT">Arrabury</Name> <Name LanguageCode="TR">Arrabury</Name> </Names> <UtcOffset>+10:00</UtcOffset> <TimeZoneId>Australia/Brisbane</TimeZoneId> </Airport> <Airport> <AirportCode>AAC</AirportCode> <Position> <Coordinate> <Latitude>31.0733</Latitude> <Longitude>33.8358</Longitude> </Coordinate> </Position> <CityCode>AAC</CityCode> <CountryCode>EG</CountryCode> <LocationType>Airport</LocationType> <Names> <Name LanguageCode="EN">El Arish International</Name> </Names> <UtcOffset>+02:00</UtcOffset> <TimeZoneId>Africa/Cairo</TimeZoneId> </Airport> <Airport> <AirportCode>AAD</AirportCode> <Position> <Coordinate> <Latitude>6.0961</Latitude> <Longitude>46.6375</Longitude> </Coordinate> </Position> <CityCode>AAD</CityCode> <CountryCode>SO</CountryCode> <LocationType>Airport</LocationType> <Names> <Name LanguageCode="EN">Adado</Name> </Names> <UtcOffset>+03:00</UtcOffset> <TimeZoneId>Africa/Mogadishu</TimeZoneId> </Airport> <Airport> <AirportCode>AAE</AirportCode> <Position> <Coordinate> <Latitude>36.8222</Latitude> <Longitude>7.8092</Longitude> </Coordinate> </Position> <CityCode>AAE</CityCode> <CountryCode>DZ</CountryCode> <LocationType>Airport</LocationType> <Names> <Name LanguageCode="EN">Annaba Rabah Bitat</Name> </Names> <UtcOffset>+01:00</UtcOffset> <TimeZoneId>Africa/Algiers</TimeZoneId> </Airport> <Airport> <AirportCode>AAF</AirportCode> <Position> <Coordinate> <Latitude>29.7333</Latitude> <Longitude>-85.0333</Longitude> </Coordinate> </Position> <CityCode>AAF</CityCode> <CountryCode>US</CountryCode> <LocationType>Airport</LocationType> <Names> <Name LanguageCode="EN">Apalachicola Regional</Name> </Names> <UtcOffset>-05:00</UtcOffset> <TimeZoneId>America/New_York</TimeZoneId> </Airport> <Airport> <AirportCode>AAG</AirportCode> <Position> <Coordinate> <Latitude>-24.1036</Latitude> <Longitude>-49.79</Longitude> </Coordinate> </Position> <CityCode>AAG</CityCode> <CountryCode>BR</CountryCode> <LocationType>Airport</LocationType> <Names> <Name LanguageCode="EN">Arapoti Avelino Vieira</Name> </Names> <UtcOffset>-03:00</UtcOffset> <TimeZoneId>America/Araguaina</TimeZoneId> </Airport> <Airport> <AirportCode>AAH</AirportCode> <Position> <Coordinate> <Latitude>50.8231</Latitude> <Longitude>6.1864</Longitude> </Coordinate> </Position> <CityCode>AAH</CityCode> <CountryCode>DE</CountryCode> <LocationType>Airport</LocationType> <Names> <Name LanguageCode="EN">Aachen Merzbrueck</Name> </Names> <UtcOffset>+01:00</UtcOffset> <TimeZoneId>Europe/Berlin</TimeZoneId> </Airport> <Airport> <AirportCode>AAI</AirportCode> <Position> <Coordinate> <Latitude>-12.9167</Latitude> <Longitude>-46.9333</Longitude> </Coordinate> </Position> <CityCode>AAI</CityCode> <CountryCode>BR</CountryCode> <LocationType>Airport</LocationType> <Names> <Name LanguageCode="DE">Arraias</Name> <Name LanguageCode="EL">Αράϊας</Name> <Name LanguageCode="EN">Arraias</Name> <Name LanguageCode="ES">Arraias</Name> <Name LanguageCode="FR">Arraias</Name> <Name LanguageCode="IT">Arraias</Name> <Name LanguageCode="TR">Arraias</Name> </Names> <UtcOffset>-03:00</UtcOffset> <TimeZoneId>America/Araguaina</TimeZoneId> </Airport> <Airport> <AirportCode>AAJ</AirportCode> <Position> <Coordinate> <Latitude>3.9</Latitude> <Longitude>-55.3667</Longitude> </Coordinate> </Position> <CityCode>AAJ</CityCode> <CountryCode>SR</CountryCode> <LocationType>Airport</LocationType> <Names> <Name LanguageCode="EN">Awaradam Cajana</Name> </Names> <UtcOffset>-03:00</UtcOffset> <TimeZoneId>America/Paramaribo</TimeZoneId> </Airport> <Airport> <AirportCode>AAK</AirportCode> <Position> <Coordinate> <Latitude>0.1853</Latitude> <Longitude>173.6369</Longitude> </Coordinate> </Position> <CityCode>AAK</CityCode> <CountryCode>KI</CountryCode> <LocationType>Airport</LocationType> <Names> <Name LanguageCode="DE">Aranuka</Name> <Name LanguageCode="EL">Αρανούκα</Name> <Name LanguageCode="EN">Aranuka</Name> <Name LanguageCode="ES">Aranuka</Name> <Name LanguageCode="FR">Aranuka</Name> <Name LanguageCode="IT">Aranuka</Name> <Name LanguageCode="TR">Aranuka</Name> </Names> <UtcOffset>+12:00</UtcOffset> <TimeZoneId>Pacific/Tarawa</TimeZoneId> </Airport> <Airport> <AirportCode>AAL</AirportCode> <Position> <Coordinate> <Latitude>57.0928</Latitude> <Longitude>9.8492</Longitude> </Coordinate> </Position> <CityCode>AAL</CityCode> <CountryCode>DK</CountryCode> <LocationType>Airport</LocationType> <Names> <Name LanguageCode="BG">Aalborg</Name> <Name LanguageCode="CS">Aalborg</Name> <Name LanguageCode="DE">Aalborg</Name> <Name LanguageCode="EN">Aalborg</Name> <Name LanguageCode="ES">Aalborg</Name> <Name LanguageCode="FR">Aalborg</Name> <Name LanguageCode="HU">Aalborg</Name> <Name LanguageCode="IT">Aalborg</Name> <Name LanguageCode="JA">オールボア</Name> <Name LanguageCode="KA">奧爾堡</Name> <Name LanguageCode="KR">올보르그</Name> <Name LanguageCode="PL">Aalbork</Name> <Name LanguageCode="PT">Aalborg</Name> <Name LanguageCode="RO">Aalborg</Name> <Name LanguageCode="RU">Ольборг</Name> <Name LanguageCode="SV">Aalborg</Name> <Name LanguageCode="UK">Aalborg</Name> <Name LanguageCode="ZH">奥尔堡</Name> </Names> <UtcOffset>+01:00</UtcOffset> <TimeZoneId>Europe/Copenhagen</TimeZoneId> </Airport> <Airport> <AirportCode>AAM</AirportCode> <Position> <Coordinate> <Latitude>-24.8181</Latitude> <Longitude>31.5447</Longitude> </Coordinate> </Position> <CityCode>AAM</CityCode> <CountryCode>ZA</CountryCode> <LocationType>Airport</LocationType> <Names> <Name LanguageCode="DE">Mala Mala</Name> <Name LanguageCode="EL">Μάλα Μάλα</Name> <Name LanguageCode="EN">Mala Mala</Name> <Name LanguageCode="ES">Mala Mala</Name> <Name LanguageCode="FR">Mala Mala</Name> <Name LanguageCode="IT">Mala Mala</Name> <Name LanguageCode="TR">Mala Mala</Name> </Names> <UtcOffset>+02:00</UtcOffset> <TimeZoneId>Africa/Johannesburg</TimeZoneId> </Airport> <Airport> <AirportCode>AAN</AirportCode> <Position> <Coordinate> <Latitude>24.2617</Latitude> <Longitude>55.6092</Longitude> </Coordinate> </Position> <CityCode>AAN</CityCode> <CountryCode>AE</CountryCode> <LocationType>Airport</LocationType> <Names> <Name LanguageCode="EN">Al Ain International</Name> </Names> <UtcOffset>+04:00</UtcOffset> <TimeZoneId>Asia/Dubai</TimeZoneId> </Airport> <Airport> <AirportCode>AAO</AirportCode> <Position> <Coordinate> <Latitude>9.4167</Latitude> <Longitude>-64.4667</Longitude> </Coordinate> </Position> <CityCode>AAO</CityCode> <CountryCode>VE</CountryCode> <LocationType>Airport</LocationType> <Names> <Name LanguageCode="DE">Anaco</Name> <Name LanguageCode="EL">Ανάκο</Name> <Name LanguageCode="EN">Anaco</Name> <Name LanguageCode="ES">Anaco</Name> <Name LanguageCode="FR">Anaco</Name> <Name LanguageCode="IT">Anaco</Name> <Name LanguageCode="TR">Anaco</Name> </Names> <UtcOffset>-04:00</UtcOffset> <TimeZoneId>America/Caracas</TimeZoneId> </Airport> <Airport> <AirportCode>AAP</AirportCode> <Position> <Coordinate> <Latitude>-0.3731</Latitude> <Longitude>117.2508</Longitude> </Coordinate> </Position> <CityCode>SRI</CityCode> <CountryCode>ID</CountryCode> <LocationType>Airport</LocationType> <Names> <Name LanguageCode="EN">Samarinda Ap Tumenggung</Name> </Names> <UtcOffset>+08:00</UtcOffset> <TimeZoneId>Asia/Makassar</TimeZoneId> </Airport> <Airport> <AirportCode>AAQ</AirportCode> <Position> <Coordinate> <Latitude>45.0022</Latitude> <Longitude>37.3472</Longitude> </Coordinate> </Position> <CityCode>AAQ</CityCode> <CountryCode>RU</CountryCode> <LocationType>Airport</LocationType> <Names> <Name LanguageCode="BG">Anapa</Name> <Name LanguageCode="CS">Anapa</Name> <Name LanguageCode="DE">Anapa</Name> <Name LanguageCode="EN">Anapa</Name> <Name LanguageCode="FR">Anapa</Name> <Name LanguageCode="HU">Anapa</Name> <Name LanguageCode="RO">Anapa</Name> <Name LanguageCode="SV">Anapa</Name> <Name LanguageCode="UK">Anapa</Name> </Names> <UtcOffset>+03:00</UtcOffset> <TimeZoneId>Europe/Moscow</TimeZoneId> </Airport> <Airport> <AirportCode>AAR</AirportCode> <Position> <Coordinate> <Latitude>56.3039</Latitude> <Longitude>10.6194</Longitude> </Coordinate> </Position> <CityCode>AAR</CityCode> <CountryCode>DK</CountryCode> <LocationType>Airport</LocationType> <Names> <Name LanguageCode="BG">Aarhus</Name> <Name LanguageCode="CS">Aarhus</Name> <Name LanguageCode="DE">Aarhus</Name> <Name LanguageCode="EN">Aarhus</Name> <Name LanguageCode="ES">Aarhus</Name> <Name LanguageCode="FR">Aarhus</Name> <Name LanguageCode="HU">Aarhus</Name> <Name LanguageCode="IT">Aarhus</Name> <Name LanguageCode="JA">オールフス</Name> <Name LanguageCode="KA">奧胡斯</Name> <Name LanguageCode="KR">오르후스</Name> <Name LanguageCode="PL">Aarhus</Name> <Name LanguageCode="PT">Arhus</Name> <Name LanguageCode="RO">Aarhus</Name> <Name LanguageCode="RU">Орхус</Name> <Name LanguageCode="SV">Aarhus</Name> <Name LanguageCode="UK">Aarhus</Name> <Name LanguageCode="ZH">奥胡斯</Name> </Names> <UtcOffset>+01:00</UtcOffset> <TimeZoneId>Europe/Copenhagen</TimeZoneId> </Airport> <Airport> <AirportCode>AAS</AirportCode> <Position> <Coordinate> <Latitude>-3.9167</Latitude> <Longitude>139.25</Longitude> </Coordinate> </Position> <CityCode>AAS</CityCode> <CountryCode>ID</CountryCode> <LocationType>Airport</LocationType> <Names> <Name LanguageCode="DE">Apalapsili</Name> <Name LanguageCode="EL">Απαλαψίλι</Name> <Name LanguageCode="EN">Apalapsili</Name> <Name LanguageCode="ES">Apalapsili</Name> <Name LanguageCode="FR">Apalapsili</Name> <Name LanguageCode="IT">Apalapsili</Name> <Name LanguageCode="TR">Apalapsili</Name> </Names> <UtcOffset>+09:00</UtcOffset> <TimeZoneId>Asia/Jayapura</TimeZoneId> </Airport> <Airport> <AirportCode>AAT</AirportCode> <Position> <Coordinate> <Latitude>47.7506</Latitude> <Longitude>88.0858</Longitude> </Coordinate> </Position> <CityCode>AAT</CityCode> <CountryCode>CN</CountryCode> <LocationType>Airport</LocationType> <Names> <Name LanguageCode="DE">Altay</Name> <Name LanguageCode="EL">Αλτάϊ</Name> <Name LanguageCode="EN">Altay</Name> <Name LanguageCode="ES">Altay</Name> <Name LanguageCode="FR">Altay</Name> <Name LanguageCode="IT">Altay</Name> <Name LanguageCode="TR">Altay</Name> </Names> <UtcOffset>+08:00</UtcOffset> <TimeZoneId>Asia/Urumqi</TimeZoneId> </Airport> </Airports> <Meta Version="1.0.0"> <Link Href="https://api.lufthansa.com/v1/mds-references/airports" Rel="self"/> <Link Href="https://api.lufthansa.com/v1/mds-references/airports?offset=20&amp;limit=20" Rel="next"/> <Link Href="https://api.lufthansa.com/v1/mds-references/airports?offset=11620&amp;limit=20" Rel="last"/> <Link Href="https://api.lufthansa.com/v1/references/cities/{cityCode}" Rel="related"/> <Link Href="https://api.lufthansa.com/v1/references/countries/{countryCode}" Rel="related"/> <TotalCount>11640</TotalCount> </Meta> </AirportResource>
<?xml version="1.0" encoding="UTF-8"?>
<AirportResource>
<Airports>
<Airport>
<AirportCode>TXL</AirportCode>
<Position>
<Coordinate>
<Latitude>52.5597</Latitude>
<Longitude>13.2878</Longitude>
</Coordinate>
</Position>
<CityCode>BER</CityCode>
<CountryCode>DE</CountryCode>
<LocationType>Airport</LocationType>
<Names>
<Name LanguageCode="EN">Berlin</Name>
</Names>
<UtcOffset>+01:00</UtcOffset>
<TimeZoneId>Europe/Berlin</TimeZoneId>
</Airport>
</Airports>
<Meta Version="1.0.0">
<Link Href="https://api.lufthansa.com/v1/mds-references/airports/TXL" Rel="self"/>
<Link Href="https://api.lufthansa.com/v1/references/cities/BER" Rel="related"/>
<Link Href="https://api.lufthansa.com/v1/references/countries/DE" Rel="related"/>
<Link Href="http://travelguide.lufthansa.com/de/de/berlin/TXL" Rel="alternate"/>
<Link Href="http://travelguide.lufthansa.com/de/en/berlin/TXL" Rel="alternate"/>
<Link Href="http://travelguide.lufthansa.com/de/cn/berlin/TXL" Rel="alternate"/>
<Link Href="http://travelguide.lufthansa.com/de/es/berlin/TXL" Rel="alternate"/>
<Link Href="http://travelguide.lufthansa.com/de/fr/berlin/TXL" Rel="alternate"/>
<Link Href="http://travelguide.lufthansa.com/de/it/berlino/TXL" Rel="alternate"/>
<Link Href="http://travelguide.lufthansa.com/de/pt/berlim/TXL" Rel="alternate"/>
</Meta>
</AirportResource>
Docs Navigation
- Lufthansa Open API
- Getting Started
- Public API Method Details
- Flight Schedules
- Reference Data
- Offers
- Operations
- Flight Schedules
- Flight Status
- Flight Status by Route
- Flight Status at Arrival Airport
- Flight Status at Departure Airport
- Flight Status Response
- Customer Flight Information
- Customer Flight Information at Arrival Airport
- Customer Flight Information by Route
- Customer Flight Information at Departure Airport
- Customer Flight Information Response
- Notifications
- cargo
- Partner API Method Details
- FlightOps/Crew API Method Details