API reference
Financial ratios
Track margins, equity ratio, returns and other ratios over time.
- Access
-
Scope
financials - Cost
- 1 unit per year in the response
The ratios are pre-calculated for each year and use the same definitions as the company views on firmainfo.se.
Parameters
Parameters not marked as required may be omitted.
| Name | Type | What the field does |
|---|---|---|
company_id
Required
|
string |
The company's ten-digit registration number, with or without the hyphen, or the company's public token. An exact personal identity number works when the key holds the person_lookup scope.
|
years
|
integer |
How many financial years to return, from 1 to 20.
Default: 10
|
Request and response
The example shows a request against the production environment and a successful response.
curl "https://firmainfo.se/api/v1/companies/5560125790/financial-ratios?years=3" \
-H "Authorization: Bearer $FIRMAINFO_API_KEY"
{
"company": { "id": "5560125790", "name": "Aktiebolaget Volvo", "registration_number": "556012-5790" },
"series": [
{
"fiscal_year_end": "2024-12-31",
"profit_margin_pct": "12.53",
"net_margin_pct": "10.48",
"operating_margin_pct": "12.01",
"solidity_pct": "31.02",
"debt_to_equity": "2.22",
"roe_allabolag_pct": "23.38",
"return_on_assets_pct": "8.67",
"ebitda": 89123000000,
"altman_z_score": "2.91",
"altman_zone": "safe"
}
]
}