Getting entities

Getting an entity from the API is pretty straight forward. All you need is the URL, your API key and a Lasso Id or CVR number.

Companies

Let start by getting the company Lasso X from CVR:

GET api.lassox.com/v2/CVR-1-34580820

{
    "name": "LASSO X ApS",
    "localIdentifierTypeName": "CVR-nummer",
    "localIdentifier": "34580820",
    "accountNumber": null,
    "segment": null,
    "statusCode": "NORMAL",
    "statusText": "NORMAL",
    "companyType": "Aktieselskab",
    "employees": "10-19",
    "employeeCount": 15,
    "primaryIndustry": "Databehandling, webhosting og lignende serviceydelser",
    "primaryIndustryCode": "631100",
    "secondaryIndustry": "Konsulentbistand vedrørende informationsteknologi",
    "secondaryIndustryCode": "620200",
    "primaryContact": null,
    "places": [ // Production units
        {
            "localIdentifierTypeName": "P-Nummer",
            "localIdentifier": "1017689386",
            "lassoId": "CVR-2-1017689386",
            "entityType": "Place"
        }
    ],
    "people": null,
    "lassoId": "CVR-1-34580820",
    "entityType": "Company",
    "identifiers": null,
    "address1": "Rådhuspladsen 37",
    "address2": null,
    "zipCode": "1550",
    "postalCode": "1550",
    "city": "København V",
    "country": "Danmark",
    "telephone": "71747812",
    "fax": null,
    "email": "kontakt@lasso.dk",
    "website": "www.lassox.com",
    "houseNo": "37",
    "houseLetter": "",
    "streetName": "Rådhuspladsen",
    "municipality": "KØBENHAVN"
}

Don't forget to add your API key using ?accesskey=api_key.

The above request returns a JSON object with limited information that supports most needs. If you want to receive all available data, including historical information, add &full=true to the request url. Download a sample here.

This works for places, people and search too!

The response is an entity with all the basic information about Lasso X, fetched directly from CVR. Had you integrated to e-conomic, you could query for a company instead using the same url, but with a different Lasso Id, e.g: ECO-1-987. The result would be an object with the same fields, but with diferent values; this time from your e-conomic solution.

The above method is actually shorthand for a bit more verbose url, which could be useful if you only have the CVR number, and do not want to create the Lasso Id:

GET api.lassox.com/v2/providers/CVR/company/34580820

Knowing the above, we are now able to query for people and places too

Places (production units)

Places are locations where a company has a department. In CVR terms, this is a production unit, or "produktionsenhed" in danish.

Getting data for a place is equally simple as for a company:

GET api.lassox.com/v2/CVR-2-1017689386

{
    "name": "LASSO X ApS",
    "localIdentifierTypeName": "P-nummer",
    "localIdentifier": "1017689386",
    "statusCode": "Aktiv",
    "statusText": null,
    "employees": "5-9",
    "primaryIndustryCode": "631100",
    "primaryIndustry": "Databehandling, webhosting og lignende serviceydelser",
    "secondaryIndustry1": null,
    "secondaryIndustry2": null,
    "secondaryIndustry3": null,
    "company": { // Parent company
        "localIdentifierTypeName": "CVR-Nummer",
        "localIdentifier": "34580820",
        "lassoId": "CVR-1-34580820",
        "entityType": "Company"
    },
    "people": null,
    "lassoId": "CVR-2-1017689386",
    "entityType": "Place",
    "identifiers": null,
    "address1": "Nørrebrogade 36A 1.",
    "address2": null,
    "zipCode": "2200",
    "postalCode": "2200",
    "city": "København N",
    "country": "Danmark",
    "telephone": "60409090",
    "fax": null,
    "email": "contact@lassox.com",
    "website": null,
    "houseNo": "36",
    "houseLetter": "A",
    "streetName": "Nørrebrogade"
}

which is shorthand for

GET api.lassox.com/v2/providers/CVR/place/1017689386

This returns an object with information about the production unit, e.g. the address, the parent company etc.

It is possible to get all the places related to a specific company. The below example gets all the places for Lasso X, returned as an array:

GET api.lassox.com/v2/CVR-1-34580820/related/place

People

To get a person, simply follow the same conventions:

api.lassox.com/v2/CVR-3-4000744745

{
    "firstName": "Jeppe",
    "lastName": "Andreas Bech Madsen",
    "role": null,
    "roleDetails": null,
    "department": null,
    "company": { // Most recent company relation
        "name": "LASSO X ApS",
        "localIdentifierTypeName": "CVR-Nummer",
        "localIdentifier": "34580820",
        "lassoId": "CVR-1-34580820",
        "entityType": "Company"
    },
    "relations": [ // Company relations
        {
            "roles": [
                "Stifter",
                "Administrerende Direktør",
                "Reel Ejer",
                "Ejer",
                "Stemmeberettiget",
                "Stremmeberettiget (reelt)"
            ],
            "company": {
                "displayName": "JEBEMA HOLDING IVS",
                "lassoId": {
                    "entityType": "Company",
                    "contentProvider": "VIRK",
                    "lassoId": "CVR-1-32343554",
                    "key": "32343554"
                }
            }
        },
        {
            "roles": [
                "Stifter",
                "Direktør",
                "Reel Ejer",
                "Stremmeberettiget (reelt)"
            ],
            "company": {
                "displayName": "LASSO X ApS",
                "lassoId": {
                    "entityType": "Company",
                    "contentProvider": "VIRK",
                    "lassoId": "CVR-1-34580820",
                    "key": "34580820"
                }
            }
        }
    ],
    "lassoId": "CVR-3-4000744745",
    "entityType": "Person",
    "identifiers": null,
    "address1": "Skydebanegade 5 4. th.",
    "address2": null,
    "zipCode": null,
    "postalCode": "1709",
    "city": "København V",
    "country": "Danmark",
    "telephone": null,
    "fax": null,
    "email": null,
    "website": null,
    "houseNo": "5",
    "houseLetter": "",
    "streetName": "Skydebanegade"
}

which is shorthand for

GET api.lassox.com/v2/providers/CVR/person/4000744745

To get all the people related to a specific company, use the following endpoint, which return an array of people:

GET api.lassox.com/v2/CVR-1-34580820/related/person

Now that you know how the data looks, click here to learn how to search for entities.