Below you'll find the API changes compared to version 2.1, we've summed up all changes below. We've add the endpoints which it effects below the description and the schema which is changed between parentheses. All changes are already updated in the present documentation.
Added estimate field to paginated results and limit the maximum results to 2000. (Pagination)
To speed up search results, we now included an approximately total count for the first page, this total count may change at the next pages you may query. Also the maximum result count will never exceed the 2000 limit, if you wish different results you need to change your search query.
- /denominations
- /addresses
Added the countryCode field to addresses, along with the English and German translations of the country name to the country field. (Address)
- /addresses
- /enterprise/{enterpriseNumber}/address
- /establishment/{establishmentNumber}/address
The field entityType wasn't consistently available for all endpoints, this is now fixed. (Address)
- /addresses
- /enterprise/{enterpriseNumber}/address
- /establishment/{establishmentNumber}/address
Endpoint /enterprise/{enterpriseNumber}/address/{type} and /enterprise/{enterpriseNumber}/addresses are deprecated, in favor of /enterprise/{enterpriseNumber}/address.
An enterprise may only have one address, so the old naming was confusing.
- /enterprise/{enterpriseNumber}/address/{type}
- /enterprise/{enterpriseNumber}/addresses
Endpoint /establishment/{establishmentNumber}/denomination/{language}/{type} is marked deprecated, in favor of /establishment/{establishmentNumber}/denomination/{language}.
The establishment denomination type is always
commercial, so it makes no sense to filter on this value.
- /establishment/{establishmentNumber}/denomination/{language}/{type}
Deprecated fields juridicalSituationDescription, juridicalSituationCode, juridicalFormDescription, juridicalFormCode are removed in favor of juridicalSituation and JuridicalForm objects. (Enterprise)
- /enterprise/{enterpriseNumber}
Field status is now marked deprecated in favor of active, which returns a boolean. (Enterprise)
- /enterprise/{enterpriseNumber}
Added active field, which returns a boolean. (Establishment)
- /establishment/{establishmentNumber}
English and German translations are added to all NACE codes. (Nace)
- /naces
- /nace/{naceVersion}/{naceCode}
- /enterprise/{enterpriseNumber}/activities
- /establishment/{establishmentNumber}/activities
English translations are added for all Juridical Forms and Juridical Situations. (JuridicalForm and JuridicalSitation)
- /juridical-forms
- /juridical-situations
- /enterprise/{enterpriseNumber}
Deprecated fields type and typeDescription from addresses. (Address)
Did not have any added value.
- /addresses
- /enterprise/{enterpriseNumber}/address
- /establishment/{establishmentNumber}/address
Deprecated field dateRevoke, and will always return null from now on. (Address)
This field was once incorrectly translated and represented an incorrect value.
- /addresses
- /enterprise/{enterpriseNumber}/address
- /establishment/{establishmentNumber}/address
The fax type for contact information will no longer be returned. (Contact)
Who still uses a fax right? (Right?)
- /enterprise/{enterpriseNumber}/contact
- /establishment/{enterpriseNumber}/contact
All NACE 2003 codes are removed and will no longer be returned. (Nace)
- /naces
- /nace/{naceVersion}/{naceCode}
- /enterprise/{enterpriseNumber}/activities
- /establishment/{establishmentNumber}/activities
Removed username field and added companyName
- /me
Renamed planDescription to planName
- /me