FinancialReports
  1. Languages
FinancialReports
  • FinancialReports API Documentation
  • Changelog
  • Companies
    • List Companies
      GET
    • Retrieve Company Details
      GET
  • Filings
    • List Filings
      GET
    • Retrieve Filing Markdown
      GET
    • Retrieve Filing Details
      GET
  • Filing Types
    • Understanding Filing Types
    • List Filing Types
      GET
    • Retrieve Filing Type
      GET
  • Languages
    • Understanding Language Codes
    • List Languages
      GET
    • Retrieve Language
      GET
  • ISIC Classifications
    • Understanding ISIC Classification
    • List ISIC Classes
      GET
    • Retrieve ISIC Class
      GET
    • List ISIC Divisions
      GET
    • Retrieve ISIC Division
      GET
    • List ISIC Groups
      GET
    • Retrieve ISIC Group
      GET
    • List ISIC Sections
      GET
    • Retrieve ISIC Section
      GET
  • Countries
    • Understanding Country Codes
    • List Countries
      GET
    • Retrieve Country
      GET
  • Sources
    • Understanding Data Sources
    • List Data Sources
    • Retrieve Data Source
  • Watchlist
    • Get User's Watchlist
    • Add Company to Watchlist
    • Remove Company from Watchlist
  • schema
    • schema_retrieve
  1. Languages

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.

Example: API Response Format#

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.
ISO 639 Language Codes
Modified at 2025-08-16 08:34:20
Previous
Retrieve Filing Type
Next
List Languages
Built with