Hoppa till innehåll
Firmainfo Docs API v1 for Swedish company data
API reference OpenAPI Status
English
Menu and API reference

Guide

Usage and units

How API calls, returned rows and contact details count against your plan limits.

Consumption is based on the amount of data actually returned. A single company lookup therefore uses one unit, while a list of fifty rows uses fifty. A lookup with no match costs nothing at all. The model makes cost easy to tie to value.

Type of responseUnits used
One company1 unit
Company list or batch1 unit per match
Accounts with detail=summary1 unit per financial year
Accounts with detail=statements2 units per financial year
Accounts with detail=extended3 units per financial year
Market data, trademarks and workplaces1 unit per row returned
Trademark events1 unit per group of 10 events
Contact lookup3 units and 1 contact when an email address is returned
/me, /status, /health, /metadata/*Free

Cost by type of call

Alongside data units, the plan counts how many distinct companies you have retrieved profile data for during the month. The same company counts once even if you use several resources.

That limit is only affected when you retrieve data about a specific company, for example /companies/{id}, accounts, workplaces or batch lookups. The following cost data units but no unique companies:

  • The company screener GET /companies, however many rows you page through.
  • The market feeds for insider trading and short selling.
  • The change feed /changes and the trademark search.

So you can search and qualify a selection freely, and only spend unique companies once you actually pull the profiles. The limit exists to separate a targeted integration from a copy of the registry.

Responses that cost nothing

  • Lookups with no match. A 404 draws neither data units nor unique companies. You never pay for a company that does not exist.
  • Authentication errors with 401 and permission errors with 403.
  • Validation errors with 422 and invalid page cursors with 400.
  • Server errors with 5xx, and responses throttled with 429.
  • The system resources /health, /status, /me and /metadata/*.

In other words: you are charged for data you get back, not for attempts. That makes it risk-free to look up a list of company registration numbers when you do not know how many are still in the registry.