Cities

A directory of all available cities. You can retrieve the full set or details of one particular city. Not all languages are available for all cities but these codes are always supported; de, en, fr, es, it.

The resource contains the name and GPS location of each city and a list of its airports.

Request URIs

Code snippet: Call

GET /references/cities
GET /references/cities/{cityCode}[?lang={languageCode}]
GET /references/cities[?limit={recordLimit}][&][offset={recordOffset}]
Variable Description Format
{cityCode} Optionally return only this city. 3-letter IATA city code, e.g. “FRA”
{languageCode} Optionally return the city name in only this language. If not present, all languages will be in the response. 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

Request Examples

Code snippet: Call

GET /references/cities
GET /references/cities/NYC 
GET /references/cities/NYC?lang=DE
GET /references/cities?limit=44&offset=123

Response Structure Definition

Key Description
CityResource Root element of city response.
.Cities Container for city elements.
..City[] Array of all available cities or one city matching the request.
...CityCode 3-letter IATA city code, e.g. “FRA”.
...CountryCode 2-letter ISO 3166-1 country code, e.g. “DE”.
...Position Physical location of a city. This data section is optional and therefore not always present.
....Coordinate
.....Latitude Decimal latitude.
.....Longitude Decimal longitude.
...Names Container for city full names.
....Name[] Array: language-specific full name of city.
@LanguageCode 2-letter ISO 639-1 language code for the corresponding item.
...Airports Container for airport IATA codes.
....AirportCode[] Array: 3-letter IATA airport codes of airports within the city,
e.g. “LCY”, “LHR” and “STN” for city of London.
.Meta Container for meta links.
..Link[]
@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

Code snippet: XML

<?xml version="1.0" encoding="UTF-8"?>
<CityResource>
  <Cities>
    <City>
      <CityCode>NYC</CityCode>
      <CountryCode>US</CountryCode>
      <Position>
        <Coordinate>
          <Latitude>40.689919</Latitude>
          <Longitude>-74.044937</Longitude>
        </Coordinate>
      </Position>
      <Names>
        <Name LanguageCode="de">New York</Name>
        <Name LanguageCode="ru">Нью-Йорк</Name>
        <Name LanguageCode="ko">뉴욕</Name>
        <Name LanguageCode="pt">Nova Iorque</Name>
        <Name LanguageCode="jp">ニューヨーク</Name>
        <Name LanguageCode="kr">뉴욕 - 존에프케네디 국제공항</Name>
        <Name LanguageCode="en">New York</Name>
        <Name LanguageCode="it">New York</Name>
        <Name LanguageCode="fr">New York</Name>
        <Name LanguageCode="es">Nueva York</Name>
        <Name LanguageCode="ka">紐約</Name>
        <Name LanguageCode="ja">ニューヨーク</Name>
        <Name LanguageCode="pl">Nowy Jork</Name>
        <Name LanguageCode="mi">纽约</Name>
      </Names>
      <Airports>
        <AirportCode>EWR</AirportCode>
        <AirportCode>JFK</AirportCode>
        <AirportCode>LGA</AirportCode>
      </Airports>
    </City>
  </Cities>
  <Meta Version="1.0.0">
    <Link Href="https://api.lufthansa.com/v1/references/cities/NYC" Rel="self"/>
    <Link Href="https://api.lufthansa.com/v1/references/countries/US" Rel="related"/>
    <Link Href="https://api.lufthansa.com/v1/references/airports/EWR" Rel="related"/>
  </Meta>
</CityResource>
<?xml version="1.0" encoding="UTF-8"?>
<CityResource>
<Cities>
  <City>
    <CityCode>ACU</CityCode>
    <CountryCode>PA</CountryCode>
    <Names>
      <Name LanguageCode="en">Achutupo</Name>
    </Names>
  </City>
  <City>
    <CityCode>ACV</CityCode>
    <CountryCode>US</CountryCode>
    <Position>
      <Coordinate>
        <Latitude>40.97805556</Latitude>
        <Longitude>-123.8913889</Longitude>
      </Coordinate>
    </Position>
    <Names>
      <Name LanguageCode="en">Arcata/Eureka</Name>
    </Names>
    <Airports>
      <AirportCode>ACV</AirportCode>
    </Airports>
  </City>
  <City>
    <CityCode>ADA</CityCode>
    <CountryCode>TR</CountryCode>
    <Position>
      <Coordinate>
        <Latitude>36.98194444</Latitude>
        <Longitude>35.28027778</Longitude>
      </Coordinate>
    </Position>
    <Names>
      <Name LanguageCode="en">Adana</Name>
    </Names>
    <Airports>
      <AirportCode>ADA</AirportCode>
    </Airports>
  </City>
  <City>
    <CityCode>ADD</CityCode>
    <CountryCode>ET</CountryCode>
    <Position>
      <Coordinate>
        <Latitude>8.977889</Latitude>
        <Longitude>38.799319</Longitude>
      </Coordinate>
    </Position>
    <Names>
      <Name LanguageCode="en">Addis Ababa</Name>
    </Names>
    <Airports>
      <AirportCode>ADD</AirportCode>
    </Airports>
  </City>
  <City>
    <CityCode>ADE</CityCode>
    <CountryCode>YE</CountryCode>
    <Position>
      <Coordinate>
        <Latitude>12.82888889</Latitude>
        <Longitude>45.02972222</Longitude>
      </Coordinate>
    </Position>
    <Names>
      <Name LanguageCode="en">Aden</Name>
    </Names>
  </City>
  <City>
    <CityCode>ADF</CityCode>
    <CountryCode>TR</CountryCode>
    <Position>
      <Coordinate>
        <Latitude>37.763889</Latitude>
        <Longitude>38.277778</Longitude>
      </Coordinate>
    </Position>
    <Names>
      <Name LanguageCode="en">Adiyaman</Name>
    </Names>
  </City>
  <City>
    <CityCode>ADG</CityCode>
    <CountryCode>US</CountryCode>
    <Position>
      <Coordinate>
        <Latitude>41.8675</Latitude>
        <Longitude>-83.92277778</Longitude>
      </Coordinate>
    </Position>
    <Names>
      <Name LanguageCode="en">Adrian</Name>
    </Names>
  </City>
  <City>
    <CityCode>ADH</CityCode>
    <CountryCode>RU</CountryCode>
    <Position>
      <Coordinate>
        <Latitude>34.80416667</Latitude>
        <Longitude>-95.32888889</Longitude>
      </Coordinate>
    </Position>
    <Names>
      <Name LanguageCode="en">Aldan</Name>
    </Names>
  </City>
  <City>
    <CityCode>ADI</CityCode>
    <CountryCode>NA</CountryCode>
    <Position>
      <Coordinate>
        <Latitude>-21.53333333</Latitude>
        <Longitude>14.98333333</Longitude>
      </Coordinate>
    </Position>
    <Names>
      <Name LanguageCode="en">Arandis</Name>
    </Names>
  </City>
  <City>
    <CityCode>ADK</CityCode>
    <CountryCode>US</CountryCode>
    <Position>
      <Coordinate>
        <Latitude>51.87777778</Latitude>
        <Longitude>-175.3541667</Longitude>
      </Coordinate>
    </Position>
    <Names>
      <Name LanguageCode="en">Adak Island</Name>
    </Names>
    <Airports>
      <AirportCode>ADK</AirportCode>
    </Airports>
  </City>
  <City>
    <CityCode>ADL</CityCode>
    <CountryCode>AU</CountryCode>
    <Position>
      <Coordinate>
        <Latitude>-34.945</Latitude>
        <Longitude>138.530556</Longitude>
      </Coordinate>
    </Position>
    <Names>
      <Name LanguageCode="en">Adelaide</Name>
    </Names>
    <Airports>
      <AirportCode>ADL</AirportCode>
    </Airports>
  </City>
  <City>
    <CityCode>ADM</CityCode>
    <CountryCode>US</CountryCode>
    <Position>
      <Coordinate>
        <Latitude>34.30416667</Latitude>
        <Longitude>-96.97944444</Longitude>
      </Coordinate>
    </Position>
    <Names>
      <Name LanguageCode="en">Ardmore</Name>
    </Names>
  </City>
  <City>
    <CityCode>ADN</CityCode>
    <CountryCode>CO</CountryCode>
    <Names>
      <Name LanguageCode="en">Andes</Name>
    </Names>
  </City>
  <City>
    <CityCode>ADO</CityCode>
    <CountryCode>AU</CountryCode>
    <Names>
      <Name LanguageCode="en">Andamooka</Name>
    </Names>
  </City>
  <City>
    <CityCode>ADP</CityCode>
    <CountryCode>LK</CountryCode>
    <Position>
      <Coordinate>
        <Latitude>8.3</Latitude>
        <Longitude>80.47861111</Longitude>
      </Coordinate>
    </Position>
    <Names>
      <Name LanguageCode="en">Anuradhapura</Name>
    </Names>
  </City>
  <City>
    <CityCode>ADQ</CityCode>
    <CountryCode>US</CountryCode>
    <Position>
      <Coordinate>
        <Latitude>57.74972222</Latitude>
        <Longitude>-151.5063889</Longitude>
      </Coordinate>
    </Position>
    <Names>
      <Name LanguageCode="en">Kodiak</Name>
    </Names>
    <Airports>
      <AirportCode>ADQ</AirportCode>
    </Airports>
  </City>
  <City>
    <CityCode>ADR</CityCode>
    <CountryCode>US</CountryCode>
    <Names>
      <Name LanguageCode="en">Andrews</Name>
    </Names>
  </City>
  <City>
    <CityCode>ADT</CityCode>
    <CountryCode>US</CountryCode>
    <Position>
      <Coordinate>
        <Latitude>39.83972222</Latitude>
        <Longitude>-100.9577778</Longitude>
      </Coordinate>
    </Position>
    <Names>
      <Name LanguageCode="en">Ada</Name>
    </Names>
  </City>
  <City>
    <CityCode>ADU</CityCode>
    <CountryCode>IR</CountryCode>
    <Position>
      <Coordinate>
        <Latitude>38.32666667</Latitude>
        <Longitude>48.42416667</Longitude>
      </Coordinate>
    </Position>
    <Names>
      <Name LanguageCode="en">Ardabil</Name>
    </Names>
  </City>
  <City>
    <CityCode>ADV</CityCode>
    <CountryCode>GB</CountryCode>
    <Names>
      <Name LanguageCode="en">Andover</Name>
    </Names>
  </City>
</Cities>
<Meta Version="1.0.0">
  <Link Href="https://api-test.lufthansa.com/v1/references/cities/?limit=20&callerid=9twybe6vs2ndfuczadhb37z5&customerid=LH&callid=1fbe6eff-3f29-44bb-bb15-45effc84b8fd&offset=60&lang=en&applicationid=OPENAPI_EXT_GW" Rel="self"/>
  <Link Href="https://api-test.lufthansa.com/v1/references/cities/?limit=20&callerid=9twybe6vs2ndfuczadhb37z5&customerid=LH&callid=1fbe6eff-3f29-44bb-bb15-45effc84b8fd&offset=0&lang=en&applicationid=OPENAPI_EXT_GW" Rel="first"/>
  <Link Href="https://api-test.lufthansa.com/v1/references/cities/?limit=20&callerid=9twybe6vs2ndfuczadhb37z5&customerid=LH&callid=1fbe6eff-3f29-44bb-bb15-45effc84b8fd&offset=40&lang=en&applicationid=OPENAPI_EXT_GW" Rel="previous"/>
  <Link Href="https://api-test.lufthansa.com/v1/references/cities/?limit=20&callerid=9twybe6vs2ndfuczadhb37z5&customerid=LH&callid=1fbe6eff-3f29-44bb-bb15-45effc84b8fd&offset=80&lang=en&applicationid=OPENAPI_EXT_GW" Rel="next"/>
  <Link Href="https://api-test.lufthansa.com/v1/references/cities/?limit=20&callerid=9twybe6vs2ndfuczadhb37z5&customerid=LH&callid=1fbe6eff-3f29-44bb-bb15-45effc84b8fd&offset=8380&lang=en&applicationid=OPENAPI_EXT_GW" Rel="last"/>
  <Link Href="https://api-test.lufthansa.com/v1/references/airports/{airportCode}" Rel="related"/>
  <Link Href="https://api-test.lufthansa.com/v1/references/countries/{countryCode}" Rel="related"/>
  <TotalCount>8383</TotalCount>
</Meta>
</CityResource>