Country Info API

Introduction

This API returns detailed information about World Countries including ISO defined names, languages and currencies. United Nations and Word Bank defined region name and income level is also provided.

Try It Now

Use the form below to try out this API.

Parameters


Parameter Type Your Input Value
code string
localityLanguage string
key string

Don't have an API Key? Click here to register and get your free API Key

If you already have a BigDataCloud account, to automatically fill this field with your Api Key.



Curl



Request URL



Response


Awaiting request submission...

API Pricing

  1. Monthly Subscription
    FREE 10,000 queries/month
    Additional 10,000 queries US$1.00/month
  2. Annual Subscription
    FREE 10,000 queries/month
    Additional 10,000 queries US$0.80/month

Request Format

Order

Parameter

Required

Data type

Description

1

code

Yes

string

Country code, acceptable in:

·       ISO 3166-1 Alpha-2 code

·       ISO 3166-1 Alpha-3 code

·       ISO 3166-1 Numeric code

2

localityLanguage

No

string

Preferred language for locality names in ISO 639-1 format. Please note: all languages are supported, but not all languages are available for every location. If requested language is not available for a requested location it will default to English, if no English is available, the native, local names will be provided

3

key

Yes

string

Your API key

Response Format

Field

Data type

Description

isoAlpha2

string

ISO 3166-1 Alpha-2 code

isoAlpha3

string

ISO 3166-1 Alpha-3 code

m49Code

16 bit integer

United Nations M.49 code

name

string

Country name localised to the language as defined by ‘localityLanguage’ request parameter

isoName

string

ISO 3166-1 Country name

isoAdminLanguages

Array of <Language> objects

Administrative languages as defined by ISO 3166-1 standard

unRegion

string

Region name as defined by United Nations

currency

<Currency> object

Currency as defined by ISO 4217 standard

wbRegion

<WbNode> object

Region name as defined by World Bank

wbIncomeLevel

<WbNode> object

Income level as defined by World Bank

callingCode

string

Calling code

countryFlagEmoji

string

Country emoji

Data Objects

Language object

Field

Data type

Description

isoAlpha2

string

ISO 3166-1 Alpha-2 code

isoAlpha3

string

ISO 3166-1 Alpha-3 code

isoName

string

ISO 3166-1 Language name

nativeName

string

Language native name

Currency object

Field

Data type

Description

numericCode

string

ISO 4217 standard numeric code

code

string

ISO 4217 standard code

Name

string

ISO 4217 English name

minorUnits

byte

ISO 4217 minor units as the currency exponent  (e.g. 2 = 1/100)

WbNode object

Field

Data type

Description

id

string

Identification number

iso2Code

string

ISO 2 letters code

value

string

Value

Related APIs