Company´s interfaces

Signing Information

The Interface returns signing information in JSON- form based on the business ID or person ID.

In order to use the API you must have the valid environment-specific username and password. Before any API requests, you need to obtain an API KEY. You will get a valid API KEY (it's called a ticket) by using the ticket API (Please, read how to use ticket API).

The API KEY must be sent in the request custom header element (named ticket or x-api-key). If the API KEY value is valid then API request will be successful (http status code 200), otherwise it will fail (http status code 401). All API requests must be made over HTTPS. REQUEST THE username and password

Information returned by the interface

InformationDescription
Business ID  
Business Name Companys´ official tradename.
Status Is the company active or passive.
Procuration  
Person Name  
Date of Birth  
Role for example holders of procuration and board members.

Interface addresses

  • https://api.bisnode.fi/yritykset/v1/ProcurationInfo - Tuotantoympäristö
  • https://test.bisnode.fi/yritykset/v1/ProcurationInfo - Testiympäristö

Interface request parameters

ParameterDescription 
id Business ID or person ID, that can be put with hyphen or without X

 Example of question and answer of the interface

https://api.bisnode.fi/yritykset/v1/ProcurationInfo?id=2014838-7

The request succeeded and the interface returned the information in JSON-form

{
    "company": [
        {
            "businessId": "2014838-7",
            "companyName": "Bisnode Finland Oy",
            "status": "100",
            "statusDescription": [
                {
                    "language": "English",
                    "description": "Active"
                },
                {
                    "language": "Swedish",
                    "description": "Aktiv "
                },
                {
                    "language": "Finnish",
                    "description": "Aktiivinen"
                }
            ],
            "procurationAbstract": "NIMA12",
            "procurationAbstractDescription": [
                {
                    "language": "English",
                    "description": "By the Chair of the Board and the Managing Director, each on their own, and by any two Board members jointly"
                },
                {
                    "language": "Swedish",
                    "description": "Styrelsens ordförande och verkställande direktören vardera ensam samt två styrelsemedlemmar gemensamt"
                },
                {
                    "language": "Finnish",
                    "description": "Hallituksen puheenjohtaja ja toimitusjohtaja kumpikin yksin ja hallituksen jäsenet kaksi yhdessä"
                }
            ],
            "registrationDate": "2006-02-13T00:00:00",
            "procurationPerson": [
                {
                    "personId": "XXXXXX",
                    "personName": "Laitinen Sari Tiina",
                    "role": [
                        {
                            "roleType": "PR",
                            "roleTypeDescription": [
                                {
                                    "language": "English",
                                    "description": "Holder of procuration"
                                },
                                {
                                    "language": "Swedish",
                                    "description": "Prokurist"
                                },
                                {
                                    "language": "Finnish",
                                    "description": "Prokuristi"
                                }
                            ],
                            "procurationCode": "01",
                            "procurationDescription": [
                                {
                                    "language": "English",
                                    "description": "Representation by the holders of a procuration as follows: on his or her own."
                                },
                                {
                                    "language": "Swedish",
                                    "description": "Prokuristerna företräder bolaget ensam."
                                },
                                {
                                    "language": "Finnish",
                                    "description": "Prokuristit edustavat yhtiötä kukin yksin."
                                }
                            ],
                            "validFrom": "2006-02-13T02:00:00"
                        }
                    ],
                    "protectionOfInterests": null,
                    "descriptionOfProtectionOfInterests": null
                }
            ],
            "board": {
                "naturalPerson": [
                    {
                        "personId": "XXXXXX",
                        "firstname": "Mats Kalle",
                        "lastname": "Bergman",
                        "role": [
                            {
                                "role": "HPJ",
                                "roleDescription": [
                                    {
                                        "language": "English",
                                        "description": "Chairperson"
                                    },
                                    {
                                        "language": "Swedish",
                                        "description": "Ordförande"
                                    },
                                    {
                                        "language": "Finnish",
                                        "description": "Puheenjohtaja"
                                    }
                                ],
                                "validFrom": "2015-06-26T00:00:00"
                            }
                        ],
                        "protectionOfInterests": null,
                        "descriptionOfProtectionOfInterests": null
                    },
                    {
                        "personId": "XXXXXX",
                        "firstname": "Kari Janne",
                        "lastname": "Huutola",
                        "role": [
                            {
                                "role": "PTI",
                                "roleDescription": [
                                    {
                                        "language": "English",
                                        "description": "Auditor with principal responsibility"
                                    },
                                    {
                                        "language": "Swedish",
                                        "description": "Huvudansvarig revisor"
                                    },
                                    {
                                        "language": "Finnish",
                                        "description": "Päävastuullinen tilintarkastaja"
                                    }
                                ],
                                "validFrom": "2012-01-17T00:00:00"
                            }
                        ],
                        "protectionOfInterests": null,
                        "descriptionOfProtectionOfInterests": null
                    },
                    {
                        "personId": "XXXXXX",
                        "firstname": "Karl Mats",
                        "lastname": "Johnsson",
                        "role": [
                            {
                                "role": "HVJ",
                                "roleDescription": [
                                    {
                                        "language": "English",
                                        "description": "Ordinary member"
                                    },
                                    {
                                        "language": "Swedish",
                                        "description": "Ordinarie medlem"
                                    },
                                    {
                                        "language": "Finnish",
                                        "description": "Varsinainen jäsen"
                                    }
                                ],
                                "validFrom": "2015-06-26T00:00:00"
                            }
                        ],
                        "protectionOfInterests": null,
                        "descriptionOfProtectionOfInterests": null
                    },
                    {
                        "personId": "XXXXXX",
                        "firstname": "Juha Matti",
                        "lastname": "Ruuskanen",
                        "role": [
                            {
                                "role": "HVJ",
                                "roleDescription": [
                                    {
                                        "language": "English",
                                        "description": "Ordinary member"
                                    },
                                    {
                                        "language": "Swedish",
                                        "description": "Ordinarie medlem"
                                    },
                                    {
                                        "language": "Finnish",
                                        "description": "Varsinainen jäsen"
                                    }
                                ],
                                "validFrom": "2015-06-26T00:00:00"
                            },
                            {
                                "role": "TJ",
                                "roleDescription": [
                                    {
                                        "language": "English",
                                        "description": "Managing Director"
                                    },
                                    {
                                        "language": "Swedish",
                                        "description": "Verkställande direktör"
                                    },
                                    {
                                        "language": "Finnish",
                                        "description": "Toimitusjohtaja"
                                    }
                                ],
                                "validFrom": "2006-02-13T00:00:00"
                            }
                        ],
                        "protectionOfInterests": null,
                        "descriptionOfProtectionOfInterests": null
                    },
                    {
                        "personId": "XXXXXX",
                        "firstname": "Sari Minna",
                        "lastname": "Koskinen",
                        "role": [
                            {
                                "role": "PR",
                                "roleDescription": [
                                    {
                                        "language": "English",
                                        "description": "Holder of procuration"
                                    },
                                    {
                                        "language": "Swedish",
                                        "description": "Prokurist"
                                    },
                                    {
                                        "language": "Finnish",
                                        "description": "Prokuristi"
                                    }
                                ],
                                "validFrom": "2006-02-13T00:00:00"
                            }
                        ],
                        "protectionOfInterests": null,
                        "descriptionOfProtectionOfInterests": null
                    }
                ],
                "juristicPerson": [
                    {
                        "name": "PricewaterhouseCoopers Oy ",
                        "role": [
                            {
                                "role": "TIL",
                                "roleDescription": [
                                    {
                                        "language": "English",
                                        "description": "Auditor"
                                    },
                                    {
                                        "language": "Swedish",
                                        "description": "Revisor"
                                    },
                                    {
                                        "language": "Finnish",
                                        "description": "Tilintarkastaja"
                                    }
                                ],
                                "validFrom": "2012-01-17T00:00:00"
                            }
                        ]
                    }
                ]
            }
        }
    ],
    "Error": null
}

Attention! To use the interface you have to have a valid ticket(check out the quickquide), that has to be sent with the request, in header- element (ticket-parameters). Requests to production- and test enviroments always have to be made encrypted in https-form. In addition, enviroment based (production- and test enviroment) logins have to have valid access rights defined by Bisnode.

Please note that data coverage varies between companies. Data coverage depends e.g. on company form. Remember the Codes and Descriptions API returns all companies REST APIs code values and descriptions - read more.