Summary

Valu8 has released a new version of its Api: v2. Relating to that there are some breaking changes.

Guidelines when handling large selections of data

Downloading large selections of data has been limited in Valu8 Api v2 in favour of a new solution that allows users to download pregenerated batches containing large selections of data items. Batches covering entire countries will be created on regular basis and made availability in the Api.

The pagination function have new limitations reducting the number of items collected through different end points to 100.000 when using cursor-pagination and 5.000 when using pageNumber and pagesize. Please contact our support for more information about available packages and any potential request.

Detail changes

Changes in response relating to an empty result.

In version v2, an empty result will be returned as an empty list, rather than responding with a 404 Not Found as it did in v1 when querying for several items.

Rename of query-parameter in endpoint companies

Query parameters has been renamed to searchParameters in v2.

Endpoint has been removed.

The endpoint relations/companies/{valu8Id}/relations has been removed in v2.

New structure for the query in endpoint relations.

The query-parameters for the endpoint relations in v1 has been replaced with a query-object in v2.

Adjustments with pagination

In version v2 it has been adjustments for the pagination with pageNumber and pagesize. With v2 its now restricted to maximum numberpage 500 and maximum page size 10.

Adjustments for pagination (cursor)

When using cursor in version 2 you have to iterate until you recieve an empty list. In version 1, when the end of the list was reached the end point returned status code 404.

There is also a restriction to 100.000 items when using cursor.

Renamed properties

The response types of the endpoints companies and relations has been restructured. Many properties has been renamed/replaced. Below is a list of some of the properties that has been renamed:

• FinancialDataCurrencyCode has been renamed to localCurrencyCode.
• BeneficialOwnerUpdatedDate has been renamed to beneficialOwnerUpdatedAt.
• CompanyInfoUpdatedDate has been renamed to companyInfoUpdatedAt.
• FinancialsUpdatedDate has been renamed to financialsUpdatedAt.
• KeyPeopleUpdatedDate has been renamed to keyPeopleUpdatedAt.
• OwnersUpdatedDate has been renamed to ownersUpdatedAt.