API reference
Annual accounts
Retrieve accounts across several financial years, at the level of detail you choose.
- Access
-
Scope
financials - Cost
- 1 to 3 units per year, depending on detail
Use detail to control both the size of the response and the cost. Start with summary for lists and overviews. Move up when you genuinely need the full report.
| Level of detail | What it includes | Cost per year |
|---|---|---|
summary | Headline figures: revenue, profit, assets and employees | 1 |
statements | Income statement, balance sheet and any available cash-flow items | 2 |
extended | Personnel, pledged assets, audit, share classes, leasing and changes in equity | 3 |
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 retrieve, from 1 to 10. The most recent year comes first.
Default: 5
|
detail
|
string |
summary, statements or extended.
Default: summary
|
Request and response
The example shows a request against the production environment and a successful response.
curl "https://firmainfo.se/api/v1/companies/5560125790/financials?years=2&detail=summary" \
-H "Authorization: Bearer $FIRMAINFO_API_KEY"{
"company": { "id": "5560125790", "name": "Aktiebolaget Volvo", "registration_number": "556012-5790" },
"detail": "summary",
"reports": [
{
"fiscal_year_start": "2024-01-01",
"fiscal_year_end": "2024-12-31",
"currency": "SEK",
"data_tier": "full",
"revenue": 526816000000,
"operating_profit": 63256000000,
"profit_after_financials": 66005000000,
"net_profit": 55215000000,
"ebitda": 89123000000,
"total_assets": 761232000000,
"total_equity": 236104000000,
"average_employees": "97923.00",
"solidity_pct": "31.02",
"return_on_equity_pct": "23.38",
"altman_zone": "safe"
}
]
}