API for retrieving information about all countries.

Explore our comprehensive free API for obtaining global country information, offering details for each country, including:

Name of the country
Emoji flag of the country
ISO 3166-1 alpha-2 country code
ISO 3166-1 alpha-3 country code
List of spoken languages in the country
International dialing prefix of the country
In-depth currency information for the Country (currency code, name, and symbol)

👉 Start using our free Countries information API in less than 15 seconds.

Request example

Method: GET
Content Type: application/json
Endpoint: https://aaapis.com/api/v1/info/countries/

curl --L --X GET 'https://aaapis.com/api/v1/info/countries/' \ 
--H 'Authorization: Token YOUR_TOKEN' \ 
--H 'Content-Type: application/json' \

Response

The API will returns a response countaining a list of all countries in the world.

"countries": [
                    {
                        "name": "Italy",
                        "flag": "🇮🇹",
                        "country_code": "IT",
                        "three_digit_country_code": "ITA",
                        "language": [
                            "it",
                            "fr",
                            "vec"
                        ],
                        "phone_international_prefix": 39,
                        "currency": {
                            "code": "EUR",
                            "name": "Euro",
                            "symbol": "€"
                        }
                    },
                    {
                        "name": "Jamaica",
                        "flag": "🇯🇲",
                        "country_code": "JM",
                        "three_digit_country_code": "JAM",
                        "language": [
                            "en"
                        ],
                        "phone_international_prefix": 1,
                        "currency": {
                            "code": "JMD",
                            "name": "Jamaican Dollar",
                            "symbol": "JMD"
                        }
                    },
                    {
                        "name": "Jersey",
                        "flag": "🇯🇪",
                        "country_code": "JE",
                        "three_digit_country_code": "JEY",
                        "language": [
                            "en"
                        ],
                        "phone_international_prefix": 44,
                        "currency": {
                            "code": "GBP",
                            "name": "British Pound",
                            "symbol": "£"
                        }
                    },
                    ...
                ]}

Parameter	Type	Description
name	string	Name of the country
flag	string	Emoji flag of the country
country_code	string	ISO 3166-1 alpha-2 country code
three_digit_country_code	string	ISO 3166-1 alpha-3 country code
language	array	List of languages spoken in the country
phone_international_prefix	integer	International dialing prefix
currency	object	Information about the currency used in the country
currency.code	string	ISO 4217 currency code
currency.name	string	Name of the currency
currency.symbol	string	Symbol of the currency

HTTP Response Status Codes

Aaapis employs standard HTTP response codes to signify the outcome, whether successful or unsuccessful, of an API request.Typically, codes falling within the 2xx range signify success. Codes within the 4xx range indicate an error attributable to inadequate information provided (e.g., a missing required parameter). Codes in the 5xx range denote an error related to Aaapis' servers.

Code	Description
200	This status code indicates that the request was successful. The server successfully processed the request and is sending back the requested data.
401	This status code indicates that the request requires user authentication. The server received the request, but it needs authentication to fulfill it. This could mean that the Authorization header is missing or invalid.
400	This status code indicates that the server could not understand the request due to invalid syntax. This could mean that the JSON object in the request is malformed or missing required fields. The client must modify the request and try again.
500	This status code indicates that the server encountered an unexpected condition that prevented it from fulfilling the request. This could be due to a problem with the server itself. The client should not modify the request and can try again later.