Endpoints
- https://api.bisnode.fi/people/register-monitor/v2/register/{REGISTER ID}/items - production environment
- https://api-test.bisnode.fi/people/register-monitor/v2/register/{REGISTER ID}/items - test environment
Request parameters
Parameter | Description | |
---|---|---|
id | Register ID | M |
action |
PrepareData: Prepare new batch. If after is not given or is not valid date, system will prepare changes after last batch. Notice this operation will not return any rows, but only id of last batch. Optional Param: after={datetime} GetData: Getprepared batch by batchId . If data source does not allow this, the element related to data source is null. Param: batchId={int} PrepareAndGetData: Prepare and return changes after given date. Customer must pay per change after given date. If after is not given or is not valid datetime, system will prepare all changes after last change set. Optional Param: after={datetime} |
M |
after | If you want to prepare data after date you may use this. By default batch is prepare after last change that was delivered to you, no matter when you prepared batch. This means that by default you will get all changes just once. | |
batchId | If you PrepareData and GetData as a separate batch as a separate batch you must use batch id returned by operateion in GetData query. | |
M = Mandatory |
GET https://api-test.bisnode.fi/people/register-monitor/v2/register/{id}/items?action={action}&after={after}&batchId={batchId}
Request and response example
curl 'https://api-test.bisnode.fi/people/register-monitor/v2/register/371/items?action=prepareandgetdata&after=2017-10-16' -H 'x-api-key: ABC1234567890'
Successful API request returns results in JSON format.
{ "batchId": 2632, "errors": [], "rows": [ { "errors": [], "referencekey": "RefKey1", "bisnodeid": "FI2101004055080", "vrk": { "_rowtype": "Change", "_lastchangedat": "2017-03-29T21:10:43.567Z", "permanentaddr_addresstype": "domestic", "firstnames": "Esko", "lastname": "Esimerkki", "permanentaddr_streetaddress": "Esimerkkitie 1234", "permanentaddr_postcode": "12345", "permanentaddr_postoffice": "ESIMEMERKKINIEMI", "dateofdeath": null, "permanentaddr_startdate": "2011-03-26T00:00:00Z", "permanentaddr_municipalitycode": "263", "permanentaddr_municipalityname": "Kiuruvesi", "permanentaddr_countrycode_iso3165_numeric": "246", "permanentaddr_countryname": "Finland", "languagegroupcode": "Finnish", "isunderaged": false }, "original": { "customer_datafield2": "CUSTOMER DATAFIELD 2", "firstname": "Esko", "lastname": "Esimerkki", "postcode": "12345", "streetaddress": "Esimerkkitie 1234" } } ] }
More detailed implementation guide for the API - read more »