Understanding Country Codes

What is ISO 3166?

Our API uses the ISO 3166 standard to represent countries and their subdivisions. This is the international standard for country codes, published by the International Organization for Standardization (ISO). It defines unique codes for the names of countries, dependent territories, and special areas of geographical interest.

Using a standard code avoids ambiguity that can arise from using a country's full name, which can vary between languages or change over time.

The Parts of ISO 3166-1

The most widely used part of the standard is ISO 3166-1, which defines three different codes for each country. Our API provides all three for your convenience.

alpha-2 code: This is the most widely used code, consisting of two letters. It is prominently used for internet country code top-level domains (like .de for Germany).

alpha-3 code: A three-letter code that is often used in situations where a code needs to be more easily recognizable than the alpha-2 code.

numeric code: A three-digit code. This code is useful in systems that require script-independent (language-independent) codes.

Country Codes in the FinancialReports API

The API provides comprehensive country data based on the ISO 3166-1 standard. You can retrieve a list of all supported countries by making a GET request to the /countries/ endpoint.

The response for each country includes the English short name (name) along with the alpha_2, alpha_3, and numeric codes.

Example: API Response Format

A successful request to GET /countries/ will return a paginated list of country objects, each containing all four fields.

{
    "count": 249,
    "next": "[https://api.financialreports.eu/api/countries/?page=2](https://api.financialreports.eu/api/countries/?page=2)",
    "previous": null,
    "results": [
        {
            "name": "Germany",
            "alpha_2": "DE",
            "alpha_3": "DEU",
            "numeric": "276"
        },
        {
            "name": "France",
            "alpha_2": "FR",
            "alpha_3": "FRA",
            "numeric": "250"
        }
    ]
}

🔗 Official Resources

For more detailed information, you can browse the official standard or view the codes on user-friendly platforms.

ISO 3166 Country Codes

Wikipedia: ISO 3166-1

What is ISO 3166?#

The Parts of ISO 3166-1#

Country Codes in the FinancialReports API#

Example: API Response Format#

🔗 Official Resources#

What is ISO 3166?

The Parts of ISO 3166-1

Country Codes in the FinancialReports API

Example: API Response Format

🔗 Official Resources