Proff API

# 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-11-20

  • Remove yearsInOperation

This field will be removed completely from responses from 2025-12-20. It can be calculated from the establishedDate field:

Sample code in Java:

LocalDate.parse(establishedDate).until(LocalDate.now(clock)).getYears();

# 2025-09-12

  • Remove access to Real Owners DK

To comply with new regulations (opens new window) from Danish authorities, access to information about real owners ("Reelle ejere") for Denmark has been removed.

# 2025-06-18

  • Add available sort methods to /api/companies/register and /api/persons/business

Sorting object in search results from these endpoints are updated as follows:

The href and rel attributes are removed (they were always null). If your integration depends on these attributes being present you may need to update your integration.

A currentSort attribute is added (indicates the current sorting used). A sorts array is added with a list of available sort methods.

Previously:

"sorting": {
    "sortType": null,
    "href": null,
    "rel": null
}

New:

"sorting": {
    "currentSort": "relevance",
    "sorts": [
      {
        "sortType": "numEmployeesAsc",
        "href": "https://api.proff.no/companies/register/SE?industry=36.001&pageSize=10&sort=numEmployeesAsc",
        "rel": "related"
      }
    ]
}
  • Remove Sorting object from Pagination object

The values of this object has never been set. If you relied on this object being present you may need to update your integration.

# 2025-05-19

  • Add and change company name sort option in /api/companies/register

The sort option "companyNameDesc" has been available, but has returned results results in ascending order. This is changed to return results in ascending order.

If you have been using this option and relied on companies being sorted ascending you may need to update your integration.

If you need ascending sort order you can either specify the new "companyNameAsc" sort parameter, or leave it out for the default ordering.

# 2025-05-09

  • Add information about EHF for SE, DK and FI

Information about EHF status for Swedish, Danish and Finnish companies are also now available.

# 2025-04-29

  • Add information about EHF

EHF acceptance status has been added to RegisterCompany. See specifications for further details. This applies only to Norwegian companies.

# 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

← Pagination →