Countries Database API

Learn about the AirLabs countries database.


This section provides guidelines for the documentation of the Countries database.

Use it to integrate data into your applications and websites when you need localization or to automatically display local currency.


Example API Request:


                https://airlabs.co/api/v9/countries?code=US&api_key={{params.api_key}}
              

Request Parameters:

Parameter Description
api_key required Your API Key from acccount dashboard.
code optional Filtering by Country ISO 2 code.
code3 optional Filtering by Country ISO 3 code.
continent optional Filtering by continent code - AF, AN, AS, EU, NA, OC, SA
_fields optional Fields to return (comma separated, e.g.: name,code,code3,currency)

Example API Response:


              [{
                "code": "US",
                "code3": "USA",
                "name": "United States",
                "population": 327167434,
                "continent": "NA",
                "currency": "USD",
                "names": {
                  "hu": "Egyesült Államok",
                  "bg": "САЩ",
                  "is": "Bandaríkin",
                  "de": "Vereinigte Staaten",
                  "ku": "Dewletên Yekbûyî yên Amerîkayê",
                  "eo": "Usono",
                  "lt": "Jungtinės Valstijos",
                  "ga": "Stáit Aontaithe Mheiriceá",
                  "af": "Verenigde State van Amerika",
                  "tr": "Amerika Birleşik Devletleri",
                  "hi": "संयुक्त राज्य अमरिका",
                  "nn": "USA",
                  "id": "Amerika Serikat",
                  "cy": "Yr Unol Daleithiau",
                  "pl": "Stany Zjednoczone",
                  "ka": "ამერიკის შეერთებული შტატები",
                  "ru": "Соединенные Штаты",
                  "sl": "Združene države Amerike",
                  "eu": "Ameriketako Estatu Batuak",
                  "sv": "USA",
                  "ms": "Amerika Syarikat",
                  "ar": "الاولايات المتحدة الامريكية",
                  "uz": "Қўшма Штатлар",
                  "hy": "Ամէրիկայի Միացյալ Նահանգնէր",
                  "ca": "Estats Units",
                  "om": "United States",
                  "it": "Stati Uniti",
                  "dz": "ཡུ་ནའིཊེཊ་སི་ཊེསི",
                  "sq": "Shtetet e Bashkuara të Amerikës",
                  "fi": "Yhdysvallat",
                  "uk": "США",
                  "nb": "USA",
                  "hr": "Sjedinjene Države",
                  "be": "Злучаныя Штаты",
                  "zh": "美国",
                  "no": "USA",
                  "da": "USA",
                  "pt": "Estados Unidos",
                  "ko": "미국",
                  "en": "United States",
                  "lo": "ສະຫະລັດອາເມລິກາ",
                  "fa": "ایالات متحدهٔ امریکا",
                  "aa": "United States",
                  "mt": "Stati Uniti",
                  "he": "ארצות הברית",
                  "bn": "মার্কিন যুক্তরাষ্ট্র",
                  "vi": "Hoa Kỳ",
                  "nl": "Verenigde Staten",
                  "cs": "Spojené státy",
                  "ja": "アメリカ合衆国",
                  "km": "សហរដ្ឋអាមេរិក",
                  "ro": "Statele Unite",
                  "et": "Ameerika Ühendriigid",
                  "sk": "Spojené štáty",
                  "sr": "Сједињене Америчке Државе",
                  "lv": "United States",
                  "fo": "Sambandsríki Amerika",
                  "th": "สหรัฐอเมริกา",
                  "am": "አሜሪካ",
                  "ur": "ریاستہائے متحدہ",
                  "nd": "Amelika",
                  "bs": "Sjedinjene Američke Države",
                  "zu": "i-United States",
                  "oc": "Estats Units",
                  "kk": "АҚШ",
                  "rm": "Stadis Unids da l'America",
                  "sg": "ÂLeaa-Ôko tî Amerika",
                  "so": "Maraykanka",
                  "ff": "Dowlaaji Dentuɗi Amerik",
                  "ta": "ஐக்கிய அமெரிக்க குடியரசு",
                  "ml": "അമേരിക്കന്‍ ഐക്യനാടുകള്‍",
                  "my": "ယူနိုက်တက်စတိတ်",
                  "az": "Amerika Birləşmiş Ştatları",
                  "bo": "ཨ་མེ་རི་ཀ་",
                  "yo": "Orílẹ́ède Orilẹede Amerika",
                  "kn": "ಅಮೇರಿಕಾ ಸಂಯುಕ್ತ ಸಂಸ್ಥಾನ",
                  "el": "Ηνωμένες Πολιτείες της Αμερικής",
                  "ln": "Ameriki",
                  "mg": "Etazonia",
                  "fr": "États-Unis",
                  "ti": "አሜሪካ",
                  "ha": "Amurka",
                  "ne": "संयुक्त राज्य",
                  "bm": "Ameriki",
                  "kl": "Naalagaaffeqatigiit",
                  "rn": "Leta Zunze Ubumwe za Amerika",
                  "kw": "Statys Unys",
                  "es": "Estados Unidos",
                  "si": "එක්සත් ජනපදය",
                  "lu": "Ameriki",
                  "te": "సంయుక్త రాజ్య అమెరికా",
                  "mn": "Америкийн Нэгдсэн Улс",
                  "gl": "Estados Unidos de América",
                  "ak": "Amɛrika",
                  "br": "Stadoù-Unanet",
                  "ii": "ꂰꇩ",
                  "ki": "Amerika",
                  "se": "Amerihká Ovttastuvvan Stáhtat",
                  "sn": "Amerika",
                  "sw": "Marekani",
                  "mk": "Соединети Американски Држави",
                  "fy": "Feriene Steaten",
                  "to": "Puleʻanga fakatahataha ʻAmelika",
                  "as": "যুক্তৰাষ্ট্ৰ",
                  "ia": "Statos Unite",
                  "or": "ଯୁକ୍ତ ରାଷ୍ଟ୍ର ଆମେରିକା",
                  "ee": "USA nutome",
                  "lg": "Amerika",
                  "mr": "संयुक्त राज्ये /अमेरिका",
                  "gu": "સંયુકત રાજ્ય/ અમેરિકા"
                }
              }]
              


Response Parameters:

Parameter Description
name Country Name. Available in the Free plan.
code ISO 2 Country code. Available in the Free plan.
code ISO 3 Country code. Available in the Free plan.
population Total country population.
continent Continent code - AF, AN, AS, EU, NA, OC, SA.
currency Main currency code.
names Alternative names in different languages.

       Github    Reddit

See also

Airports Database API
Name Suggestion Service
NearBy Geo Service
Real-time Flights API
Airport Schedules API


Questions? Contact us.