Fetching updates
This guide will help you understand how you can filter on the latest updates in a full region or for a set number of companies.
Finding updates in smaller sub-sections
To filter on the latest updates in the API, we suggest use these fields: contentUpdatedAt or relationsUpdatedAt.
- contentUpdatedAt
Indicates the date when any general company information or financials were updated. This field is preferred when you are searching for data via the companies endpoint. - relationsUpdatedAt
Indicates the date when information about any key persons, owners or other relations related to the company were updated. This field is preferred when you are searching for data via the relations endpoint.
For more information about relevant fields, see page MetaData
In practice this can be used in combination with for example a list of Valu8Ids for a selection of companies you wish to screen for updates for. In that scenario simply pass the full list of Valu8Ids as one search parameter & include one of the attributes above along with the date from which you wish to find updates.
Staying up to date on large data segment
For users who are monitoring large sections of data such as whole countries we suggest using the batches feature. We create monthly base lifts of full country data for both the companies & relations endpoints as well as daily delta files for the same. Staying on track when ingesting that type of data simply requires you to read in all delta files when you're already on track with those batches. If you ever need to do a reset of your data, simply read in data from the latest base lift & all delta files created after that to todays date and you should be back on track again.