API endpoints
- https://api.bisnode.fi/yritykset/v1/FoundationRegisterEntryInfo - production environment
- https://test.bisnode.fi/yritykset/v1/FoundationRegisterEntryInfo - test environment
API request parameters
Parameter | Description | |
---|---|---|
businessId | Business ID. Can be entered with or without dash. | X |
registrationNumber | Trade register number. Can be used in request if business ID is missing. | X* |
X = Mandatory, * = Only one mandatory parameter can be used in request. If both parameters are given, only 'businessId' is taken into account. |
API response
Information | Description |
---|---|
Name | Official name of the foundation |
Business ID | Foundation's business ID |
Registration number | Trade register number |
Registration | Official registration date of the foundation |
Contact info | Contact info for the foundation |
Other info | Name history, changes, members of the government etc. |
Note! Information might be different depending on current situation of the foundation. The most general available info is listed here. |
Example of API request and respond
curl 'https://api.bisnode.fi/yritykset/v1/FoundationRegisterEntryInfo?businessId=0213537-1' -H 'ticket: 1234567890ABC'
Request succeeded with given parameters. API responded in JSON format.
{ "foundationRegisterEntryInfoResponseDetails": { "name": "Koneen Säätiö sr", "businessId": "0213537-1", "registrationNumber": null, "establishPermissionGranted": "1956-12-18T00:00:00+02:00", "registrationDate": "1957-01-11T00:00:00+02:00", "dissolutionDate": null, "domicile": { "code": "091", "registrationDate": "1957-01-11T00:00:00+02:00", "expirationDate": null }, "contactInformation": { "visitation": { "co": null, "streetAddress": "Tennarikuja 45 C 2", "zipcode": null, "city": "HELSINKI", "country": null }, "postal": { "co": null, "streetAddress": "Tennarikuja 45 C 2", "zipcode": null, "city": "HELSINKI", "country": null }, "homepage": "www.koneensaatio.fi", "phone": [ "092600555, 050 5311555" ], "fax": null, "email": "etunimi.sukunimi@koneensaatio.fi", "registrationDate": null, "expirationDate": null }, "registerEntry": [ { "headerText": "NIMI (Rekisteröity 07.10.2015 00:00:00)", "bodyText": "Säätiön nimi on Koneen Säätiö sr", "registrationDateDate": "2015-10-07T00:00:00+03:00", "expirationDate": null }, { "headerText": "KOTIPAIKKA (Rekisteröity 11.01.1957 00:00:00)", "bodyText": "Säätiön kotipaikka on Helsinki", "registrationDateDate": "1957-01-11T00:00:00+02:00", "expirationDate": null }, { "headerText": "SÄÄNTÖMUUTOS (Rekisteröity 29.07.2005 00:00:00)", "bodyText": "Säätiön säännöt ovat muuttuneet.", "registrationDateDate": "2005-07-29T00:00:00+03:00", "expirationDate": null }, { "headerText": "TARKOITUS (Rekisteröity 11.01.1957 00:00:00)", "bodyText": "Säätiön tarkoituksena on kaiken suomalaisessa yhteiskunnassa tapahtuvan kulttuurityön edistäminen niin hyvin tieteellisen tutkimustyön sekä luovan ja esittävän taiteen kuin myös teollisen, kaupallisen, teknillisen ja sosiaalisen toiminnan alalla.", "registrationDateDate": "1957-01-11T00:00:00+02:00", "expirationDate": null }, { "headerText": "HALLITUS (Rekisteröity 14.11.2014 15:20:00)", "bodyText": "Puheenjohtaja:\n01.01.1900 Numminen Armi\nVarapuheenjohtaja:\n01.01.1900 Helin Varma\nVarsinainen jäsen:\n01.01.1900 Kankkunen Pasi\n01.01.1900 Into Ilpo\n01.01.1900 Meikäläinen Maija\n01.01.1900 Matti Meikäläinen", "registrationDateDate": "2014-11-14T00:00:00+02:00", "expirationDate": null }, { "headerText": "LAKIMÄÄRÄINEN EDUSTAMINEN", "bodyText": "Lain nojalla säätiötä edustaa hallitus.", "registrationDateDate": null, "expirationDate": null }, { "headerText": "EDUSTAMINEN (Rekisteröity 11.01.1957 00:00:00)", "bodyText": "Säätiön nimen kirjoittavat hallituksen puheenjohtaja ja varapuheenjohtaja kumpikin erikseen sekä säätiön asiamies yhdessä jonkin hallituksen jäsenen kanssa.", "registrationDateDate": "1957-01-11T00:00:00+02:00", "expirationDate": null }, { "headerText": "TILINPÄÄTÖSASIAKIRJAT (Rekisteröity 12.05.2015 12:18:34)", "bodyText": "Tilinpäätös ajalta 01.01.2014-31.12.2014", "registrationDateDate": "2015-05-12T00:00:00+03:00", "expirationDate": null }, { "headerText": "HENKILÖTIEDOT", "bodyText": "01.01.1900 Meikäläinen Maija, Enontekiö, Suomi\n01.01.1900 Meikäläinen Matti, Porvoo, Suomi", "registrationDateDate": "2014-11-14T00:00:00+02:00", "expirationDate": null }, { "headerText": "NIMIHISTORIA", "bodyText": "Koneen Säätiö sr 07.10.2015-\nKoneen Säätiö 11.01.1957-07.10.2015", "registrationDateDate": "1957-01-11T00:00:00+02:00", "expirationDate": null } ], "body": [ { "type": "hal", "naturalPerson": [ { "role": "puh", "firstname": "Maija", "surname": "Meikäläinen", "socialSecurityNumber": null, "dateOfBirth": "1900-01-01T01:00:00+03:00", "status": null, "expirationDate": null }, { "role": "vaj", "firstname": "Matti", "surname": "Meikäläinen", "socialSecurityNumber": null, "dateOfBirth": "1900-01-01T01:00:00+03:00", "status": null, "expirationDate": null }, { "role": "var", "firstname": "Minna", "surname": "Meikäläinen", "socialSecurityNumber": null, "dateOfBirth": "1900-01-01T01:00:00+03:00", "status": null, "expirationDate": null }, { "role": "vpu", "firstname": "Mikko", "surname": "Meikäläinen", "socialSecurityNumber": null, "dateOfBirth": "1900-01-01T01:00:00+03:00", "status": null, "expirationDate": null } ], "juristicPerson": null, "registrationDate": "2014-11-14T00:00:00+02:00", "expirationDate": null } ], "nameHistory": [ { "name": "Koneen Säätiö sr", "registrationDate": "2015-10-07T00:00:00+03:00", "expirationDate": null }, { "name": "Koneen Säätiö", "registrationDate": "1957-01-11T00:00:00+02:00", "expirationDate": "2015-10-07T00:00:00+03:00" } ], "creationTime": "2015-12-04T15:46:13.865+02:00" }, "Error": null }