Country Info API Documentation

Endpoints:

• GET /api/countries

  Get information about all countries.

  Parameters:

  expand (boolean) - optional - Default: false Show all information about the country.
  fields: [string] - optional - Default: '' Filter which fields are returned.
  

  Fields:

  name, cca3, region, subregion, languages, currencies, timezones, area, population, independent

  Example response:

  [
    {
      "name": "France",
      "cca3": "FRA",
      "region": "Europe",
      ...
    },
    ...
  ]

• GET /api/countries/name/{name}

  Get information about a country by its common name. You can search by official name, common name or name in any translated language.

  Parameters:

  expand (boolean) - optional - Default: false Show all information about the country.
  fields: [string] - optional - Default: '' Filter which fields are returned.
  

  Fields:

  name, cca3, region, subregion, languages, currencies, timezones, area, population, independent

  Example response:

  {
    "name": "France",
    "cca3": "FRA",
    "region": "Europe",
    ...
  }

• GET /api/countries/capital/{capital}

  Get information about a country by its capital name.

  Parameters:

  expand (boolean) - optional - Default: false Show all information about the country.
  fields: [string] - optional - Default: '' Filter which fields are returned.
  

  Fields:

  name, cca3, region, subregion, languages, currencies, timezones, area, population, independent

  Example response:

  {
    "name": "France",
    "cca3": "FRA",
    "region": "Europe",
    ...
  }

• GET /api/countries/callingcode/{code}

  Get information about a country by its callingcode.

  Parameters:

  expand (boolean) - optional - Default: false Show all information about the country.
  fields: [string] - optional - Default: '' Filter which fields are returned.
  

  Fields:

  name, cca3, region, subregion, languages, currencies, timezones, area, population, independent

  Example response:

  {
    "name": "France",
    "cca3": "FRA",
    "region": "Europe",
    ...
  }

• GET /api/countries/{cca3}

  Get information about a country by its 3-letter country code.

  Parameters:

  expand (boolean) - optional - Default: false Show all information about the country.
  fields: [string] - optional - Default: '' Filter which fields are returned.
  

  Fields:

  name, cca3, region, subregion, languages, currencies, timezones, area, population, independent

  Example response:

  {
    "name": "France",
    "cca3": "FRA",
    "region": "Europe",
    ...
  }

• GET /api/regions/{region}/countries

  Get all countries in a region.

  Parameters:

  expand (boolean) - optional - Default: false Show all information about the country.
  fields: [string] - optional - Default: '' Filter which fields are returned.
  

  Fields:

  name, cca3, subregion, languages, currencies, timezones, area, population, independent

  Example response:

  [
    {
      "name": "France",
      "cca3": "FRA",
      "subregion": "Western Europe",
      ...
    },
    ...
  ]

• GET /api/subregions/{subregion}/countries

  Get all countries in a subregion.

  Parameters:

  expand (boolean) - optional - Default: false Show all information about the country.
  fields: [string] - optional - Default: '' Filter which fields are returned.
  

  Fields:

  name, cca3, region, languages, currencies, timezones, area, population, independent

  Example response:

  [
    {
      "name": "France",
      "cca3": "FRA",
      "region": "Europe",
      ...
    },
    ...
  ]

• GET /api/languages/{language}/countries

  Get all countries where a language is spoken.

  Parameters:

  expand (boolean) - optional - Default: false Show all information about the country.
  fields: [string] - optional - Default: '' Filter which fields are returned.
  

  Fields:

  name, cca3, region, subregion, languages, currencies, timezones, area, population, independent

  Example response:

  [
    {
      "name": "France",
      "cca3": "FRA",
      "region": "Europe",
      ...
    },
    ...
  ]

• GET /api/currencies/{currency}/countries

  Get all countries where a currency is used.

  Parameters:

  expand (boolean) - optional - Default: false Show all information about the country.
  fields: [string] - optional - Default: '' Filter which fields are returned.
  

  Fields:

  name, cca3, region, subregion, languages, currencies, timezones, area, population, independent

  Example response:

  [
    {
      "code": "USD",
      "name": "United States Dollar",
      "symbol": "$"
    },
    ...
  ]

• GET /api/timezones/{timezone}/countries

  Get all countries in a timezone.

  Parameters:

  expand (boolean) - optional - Default: false Show all information about the country.
  fields: [string] - optional - Default: '' Filter which fields are returned.
  

  Fields:

  name, cca3, region, subregion, languages, currencies, timezones, area, population, independent

  Example response:

  [
    {
      "name": "France",
      "cca3": "FRA",
      "region": "Europe",
      ...
    },
    ...
  ]

• GET /api/languages

  Get all unique languages.

  Parameters:

  expand (boolean) - optional - Default: false Show all information about the country.
  fields: [string] - optional - Default: '' Filter which fields are returned.
  

  Fields:

  Example response:

  [
    "English",
    "Spanish",
    "French",
    ...
  ]

• GET /api/regions

  Get all unique regions.

  Parameters:

  expand (boolean) - optional - Default: false Show all information about the country.
  fields: [string] - optional - Default: '' Filter which fields are returned.
  

  Fields:

  Example response:

  [
    "Europe",
    "Asia",
    "Africa",
    ...
  ]

• GET /api/timezones

  Get all unique timezones.

  Parameters:

  expand (boolean) - optional - Default: false Show all information about the country.
  fields: [string] - optional - Default: '' Filter which fields are returned.
  

  Fields:

  Example response:

  [
    "UTC",
    "UTC+1",
    "UTC-2",
    ...
  ]

• GET /api/currencies

  Get all unique currencies.

  Parameters:

  expand (boolean) - optional - Default: false Show all information about the country.
  fields: [string] - optional - Default: '' Filter which fields are returned.
  

  Fields:

  code, name, symbol

  Example response:

  [
    {
      "code": "USD",
      "name": "United States Dollar",
      "symbol": "$"
    },
    ...
  ]

• GET /api/population/{comparison}/{value}/countries

  Get countries based on population size.

  Parameters:

  expand (boolean) - optional - Default: false Show all information about the country.
  fields: [string] - optional - Default: '' Filter which fields are returned.
  

  Fields:

  Example response:

  [
    {
      "name": "China",
      "cca3": "CHN",
      "region": "Asia",
      ...
    },
    ...
  ]