1. Home
  2. Docs
  3. Airports API
  4. Free API Endpoints
  5. Country Search

Country Search

With this endpoint, you can search for countries and get their ISO codes.

This function is useful in a variety of applications, as we understand that aviation is not just about airports and aircraft, but it is deeply embedded in everyday’s life.

Endpoint

https://api.aviowiki.com/free/countries/search

Request Example

curl --request GET \
  --url 'https://api.aviowiki.com/free/countries/search?query=Ireland'

Test it now

Request Parameters

Parameters names followed by an asterisk (*) are mandatory.

NameTypeLocationDescription
query *stringQuery StringThe text to search in the database.
pagenumberQuery StringThe page number for pagination
sizenumberQuery StringThe size of the pages for pagination

Response

The response will be a Paged List of results. Each result object contains the following properties.

All ISO codes make reference to the ISO-3166-1 standard.

PropertyTypeDescription
iso3stringThe ISO alpha-3 code.
iso2stringThe ISO alpha-2 code.
isoNumericnumberThe ISO numerical code.
namestringThe official English name of the country.
continentstringThe continent in which the country is located. This follows a 6-continents model: Americas, Europe, Africa, Asia, Oceania and Antarctica.

Example reply

Below is a reply for query Ireland. Notice that more than one result is returned.

{
  "page": {
    "number": 0,
    "size": 10,
    "totalPages": 1,
    "totalResults": 2
  },
  "content": [
    {
      "iso3": "IRL",
      "iso2": "IE",
      "isoNumeric": 372,
      "name": "Ireland",
      "continent": "Europe"
    },
    {
      "iso3": "GBR",
      "iso2": "GB",
      "isoNumeric": 826,
      "name": "United Kingdom of Great Britain and Northern Ireland",
      "continent": "Europe"
    }
  ]
}
Was this article helpful to you? Yes No

How can we help?