Skip to main content
The API uses several types of identifiers to reference entities. Understanding how they relate is key to navigating between endpoints.

Internal IDs

Every entity has a numeric internal ID that is stable and unique within its type. These IDs are used across all API endpoints:

Registration numbers

Companies can also be looked up by their local registration number. The registration number is available as a field in search results and company details. To find a company by registration number, use the search API:
The companyId from the search result can then be used with all /companies/{id}/... endpoints.

External UUIDs

Properties and addresses from Lantmäteriet have external UUIDs. These can be used as an alternative lookup:

Watchlist IDs

Watchlists and their sub-resources use GUIDs: See Watchlists for how these are used.

Bolagsverket cases

Records from Bolagsverket’s register, such as names, addresses, share capital, signatory rules, fiscal years and liquidations, carry caseNumber and caseYear. Together they identify the case through which Bolagsverket registered the record. One case often changes several things at once, so the same case can appear on records from several endpoints. Records loaded from the complete copy of the register taken in November 2024 carry the company’s latest case at that time. That case is not necessarily the one that made that particular change. Use the pair to order the case details from Bolagsverket. This is a paid order:
See order case details.

Order IDs

Document orders are identified by GUIDs:

Connecting the dots

1

Search

Search for a company by name or registration number to get companyId.
2

Fetch details

Use GET /companies/{companyId} to get the full company record.
3

Drill into sub-resources

Use GET /companies/{companyId}/representatives to get personId values.
4

Follow connections

Use GET /persons/{personId} or POST /persons/{personId}/companies to see their other positions.
5

Monitor changes

Use POST /watchlists/{watchlistGuid}/companies/{companyId} to add the company to a watchlist.