README

African Countries

A lightweight JSON repository of all the 54 WHO recognised countries in Africa.

Each country object also returns the following:

Country Code
Country Name
Calling Code
Official Language
Capital
Currency
Country Flag
Internet users
Population

Installation

Via npm: npm install @odusanya/african-countries
Via yarn: yarn add @odusanya/african-countries

Usage

// ES6
import countries from '@odusanya/african-countries';

// ES5
var countries = require('@odusanya/african-countries');

More Info

A sample country object looks like this

  {
    'Code': 'ML',
    'Country Name': 'Mali',
    'Calling Code': 223,
    'Official Language': 'French',
    'Capital': 'Bamako',
    'Currency': 'West African CFA franc',
    'Country Flag': '🇲🇱',
    'Internet users': 249800,
    'Population': 16455903
  }

Common Use cases

const { listCountries, getCountryFromCode } = countries;

Get country info using country code

console.log(getCountryFromCode('ml')); 

// Output
{
  'Code': 'ML',
  'Country Name': 'Mali',
  'Calling Code': 223,
  'Official Language': 'French',
  'Capital': 'Bamako',
  'Currency': 'West African CFA franc',
  'Country Flag': '🇲🇱',
  'Internet users': 249800,
  'Population': 16455903
}

Get an array of all the countries in Africa

const countriesData = listCountries();
console.log(countriesData.length); // 54 
console.log(countriesData); 
// Output
[
  ...
    {
    Code: 'GM',
    'Country Name': 'Gambia',
    'Calling Code': 220,
    'Official Language': 'English',
    Capital: 'Banjul',
    Currency: 'Dalasi',
    'Country Flag': '🇬🇲',
    'Internet users': null,
    Population: 1857181
  },
  {
    Code: 'GN',
    'Country Name': 'Guinea',
    'Calling Code': 224,
    'Official Language': 'French',
    Capital: 'Conakry',
    Currency: 'Guinean franc',
    'Country Flag': '🇬🇳',
    'Internet users': 95000,
    Population: 11474383
  },
  {
    Code: 'GW',
    'Country Name': 'Guinea-Bissau',
    'Calling Code': 245,
    'Official Language': 'Portuguese',
    Capital: 'Bissau',
    Currency: 'West African CFA franc',
    'Country Flag': '🇬🇼',
    'Internet users': 37100,
    Population: 1693398
  }
  ...
]

License

MIT

Source

ISO (International Organization for Standardization)

ISO makes the list of alpha-2 country codes available for internal use and non-commercial purposes free of charge.

Contribution

Feel free to send a PR to fix, update or add new entry anytime.

Usage no npm install needed!