Entity API

The Lasso Entity API provides a RESTful way of getting data from the Danish Company Registry (CVR) and other data providers. With it you'll be able to get data about companies, people and places (production units). The following sections describe how to connect, get and search for entities.

Looking for yearly reports (nøgletal)?

This page contains information on how to get base information for entities. Check out our Module APIs if you are looking for data for more specific data.


Getting started

Connecting the the API is easy. You'll need an active subscription, your API key, and an understanding of a Lasso Id.

Connecting to the API

In order to connect to the API you must have an active paid or trial subscription. If you do not have this, sign up for a trial at our website.

The API is located at api.lassox.com. Please use SSL (https) if possible.

Authentication

For every request you make you have to include your API key. To do this, append the query parameter accessKey to your request. Say that your API key is ABC, then you will have to append the following to your query: ?accessKey=ABC

You locate your API key from the settings area when logged into Lasso. Look under Account information (Kontooplysninger) where you should see something similar to the following:

Locating your API key

Please note that your API key is personal to you. Do not share or expose your API key to third parties.

Understanding the Lasso Id

You are now ready to query the API for entities. In order to query for a specific entity like a company, you will need its unique identifier. In CVR this unique id is a CVR number for companies, and a person id for a person. On Facebook it is a facebook user id and so on.

In Lasso we use the concept of a Lasso Id:

A Lasso Id is simply an identifier that describes the type, unique id and the data source of an entity, in a single combined string.

For example, a Lasso id for the company Lasso X is CVR-1-34580820. Let's break it down:

Understanding the Lasso Id

First part is the data source identifier: CVR, identifying the Danish Company Registry. Examples of other data sources in Lasso are MSCRM (Microsoft Dynamics CRM) and ECO (e-conomic)

Second part is the entity type number: 1, identifying the type Company. Other types are 2 (production unit) and 3 (person).

Third part is the unique identifier in the given data source: 34580820, which is the CVR number in the Danish company registry. In Microsoft Dynamics CRM the unique identifier would be a Globally unique identifier (GUID), and for e-conomic it would be a an integer.

With this in mind, you can query any supported data source using only the lasso Id. The following section explains how.


Now that you know the basics, click here to learn how to get entities.