Country information retrieval API

This free API allows you to obtain details about a specific country, providing the following information:

Country name details
Emoji flag representation of the country
ISO 3166-1 alpha-2 country code
ISO 3166-1 alpha-3 country code
Comprehensive list of spoken languages in the country
International dialing prefix of the country
Information about the currencies used in the country

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

Country information retrieval API request example

Method: POST
Content Type: application/json
Endpoint: https://aaapis.com/api/v1/info/country/

curl --L --X POST 'https://aaapis.com/api/v1/info/country/' \ 
--H 'Authorization: Token YOUR_TOKEN' \ 
--H 'Content-Type: application/json' \
--data-raw '{ 
    "country": "france"
}'

You can also use the ISO 3166-1 alpha-2 country code to get information about a specific country.

curl --L --X POST 'https://aaapis.com/api/v1/info/country/' \ 
        --H 'Authorization: Token YOUR_TOKEN' \ 
        --H 'Content-Type: application/json' \
        --data-raw '{ 
            "country": "fr"
        }'

Response

The API will returns details for the specified country.

{
                    "name": "France",
                    "flag": "🇫🇷",
                    "country_code": "FR",
                    "three_digit_country_code": "FRA",
                    "language": [
                        "fr"
                    ],
                    "phone_international_prefix": 33,
                    "currency": {
                        "code": "EUR",
                        "name": "Euro",
                        "symbol": "€"
                    }
                }

Country info API 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.