Understanding Language Codes
What are ISO 639 Language Codes?#
Our API uses the ISO 639 standard for language codes. This is the internationally recognized system for representing the world's languages and language groups. Using a standardized code (e.g., en
for English) instead of the language name is crucial for information management in large systems, as different cultures may use different names for the same language, or some unrelated languages may share similar names.Our API uses these codes to specify the language of a filing, and you can retrieve a full list of supported languages.
The Parts of ISO 639#
The ISO 639 standard is divided into several parts, each serving a different purpose. The most common are:ISO 639-1: A set of two-letter codes for major, mostly national, individual languages.
ISO 639-2: A set of three-letter codes covering a larger number of widely known languages.
ISO 639-3: A comprehensive set of three-letter codes covering all known individual languages, including living, extinct, and ancient ones.
ISO 639-5: A set of three-letter codes covering language groups and families.
Language Codes in the FinancialReports API#
For simplicity and broad compatibility, our API uses the ISO 639-1 two-letter codes for all language fields. These codes are always returned in lowercase.You can retrieve a complete list of all languages supported by the API by making a GET
request to the /languages/
endpoint.A successful request to GET /languages/
will return a paginated list of language objects, each containing a code
and a name
.{
"count": 123,
"next": "[https://api.financialreports.eu/api/languages/?page=2](https://api.financialreports.eu/api/languages/?page=2)",
"previous": null,
"results": [
{
"code": "en",
"name": "English"
},
{
"code": "de",
"name": "German"
},
{
"code": "fr",
"name": "French"
}
]
}
🔗 Official Resources#
For more detailed information on the standard, you can visit the official ISO website.Modified at 2025-08-16 08:34:20