# API versions

There are two versions of the API available.

  • v 1.0: Stable version
  • v 1.1: Experimental version

To specify an API version you should set the header api-version and specify either 1.0 or 1.1.

The default version used is v 1.0.

Here is an example specifying api-version using curl:

curl \
> -H ')`))api-version: 1.1' \
> -H 'Authorization: Token <YOUR API TOKEN>' \
> https://api.proff.no/api/companies/register/NO

# Backwards compatibility

# Backwards-compatible (non-breaking) changes

From time to time we may add support for more request parameters and new fields to the response. This is considered a non-breaking change so you should make sure your application supports this.

# Backwards-incompatible (breaking) changes

Renaming or removing fields from the response or request parameters is considered a breaking change and will be introduced in new API versions.

# Changelog

# 2025-04-10

  • Update to data in location element for SE companies

We are updating all entries in the swedish company index with a more correct location structure. The countryPart field will now always contain "Hela Sverige". There is no mapping of counties to different parts of the country anymore.

Furthermore, we are taking steps to align entries in the different endpoints - /api/companies/register and /api/companies/eniropro. Until now the value of municipality would be the municipality for the first endpoint, but the city or municipality for the latter.

Previously:

"location": {
  "municipality": "Rimforsa",
  "countryPart": "Östra Mellansverige",
  "county": "Östergötlands Län",
  "countryCode": "SE"
}

New:

"location": {
  "municipality": "Kinda",
  "countryPart": "Hela Sverige",
  "county": "Östergötlands Län",
  "countryCode": "SE"
}

# 2025-03-27

  • Add new owner endpoint

Deprecated /api/companies/owner/{country}/{id} endpoint. This will be removed october 1st, 2025. This endpoint lacks data for companies without complete accounting figures.

Please migrate to the new endpoint - /api/companies/register/{country}/{id}/owners.

Not all data from the old endpoint is available in the new (e.g. addresses) but this is available from other endpoints (e.g. /api/companies/register/{country}/{id}.

# 2025-01-21

  • Changed calculation of SDI for SE. SDI no longer includes change of inventory.
  • Added new computed ADR accounting figure for SE (combination of PL_OTHER_OPP_INCOME and PL_WORK_PERF_OWN_USE_CAPITAL).

# 2024-10-30

  • Made announcements available on RegisterCompany lookups for SE

# 2024-10-22

  • Added accounts and accountRange parameters to RegisterCompany endpoint. Enables filtering search results by accounting numbers.

# 2024-10-14

  • Added status.statusDate to RegisterCompanyDetails

# 2024-10-07

  • Added birthDate to ShareholderRealOwner and ShareholderEntity

# 2024-09-25

  • Changed max limit for municipality filter group from 100 to 500

# 2024-07-30

  • Removed includeRegisterListing parameter. The registerListing is included by default, but it is a limited object. Use expand parameter to get the full registerListing.

# 2024-07-05

  • Added EmpMin and EmpMax fields to RegisterCompany

# 2024-06-07

  • Added Trials to RegisterCompanyDetails

# 2024-04-30

  • Added real owners for DK to CompanyOwner endpoint