Data for your code.
Access the catalogue, financial statements and original reports with a free token. Website downloads use CAPTCHA and do not require a personal token.
Request your token.
We will email your API token directly. If you request it again, you will receive the same active token. No password or confirmation link is needed.
We will use your email for access and notices related to your token. Complete Parquet access is approved case by case.
Available endpoints
All API endpoints accept GET and HEAD and require Authorization: Bearer <token>. Only OPTIONS is available without a token for CORS preflight.
GET /v1/metaFreshness, coverage and attributionfreeGET /v1/companiesCompany indexfreeGET /v1/companies/search?q=...Search by public name, LEI or tax identifierfreeGET /v1/companies/{public_id}Company profilefreeGET /v1/companies/{public_id}/filingsOriginal report cataloguefreeGET /v1/companies/{public_id}/financialsFinancial statements in JSONfreeGET /v1/filings/{file_id}/fileOriginal report downloadfreeGET /v1/datasets/financials.parquetComplete Parquet datasetbulkYour first query
curl
curl -H "Authorization: Bearer $EUROLEDGER_API_TOKEN" \ https://api.euroledgerhub.com/v1/companies
Python
import os
import requests
response = requests.get(
"https://api.euroledgerhub.com/v1/companies",
headers={"Authorization": f"Bearer {os.environ['EUROLEDGER_API_TOKEN']}"},
timeout=30,
)
response.raise_for_status()
companies = response.json()["companies"]Send the token in the request header. Never include it in a URL.
Parquet with separate approval.
The free plan includes original reports and company JSON. If you need /v1/datasets/financials.parquet, email [email protected] with your use case. We review each request individually.
Limits and errors
Queries and downloads are rate limited per token. Responses 401 mean a missing or invalid token; 403, insufficient permissions; 429, rate limit exceeded with Retry-After. Read the sources and terms before redistributing the data.