Versioning
The API supports a versioning scheme based on including the API major version as part of the URL. Currently version 1 (v1) is the only supported major version. The following format is used for versioning:
{base url}/api/{version}/{resource_collection}/[{identifier_level1}/identifier_level2}]
An example url for retrieving information on a specific VAT number is:
https://api.valdit.com/api/v1/vatnumberchecks/NL/806570994B01
Non-breaking changes to the API may be introduced while maintaining the same major version. Examples of such non-breaking changes are:
- *Adding additional non-mandatory fields in the requests to enhance the functionality of existing API Operations
- Adding new elements in the response models to provide additional information on the returned resources
- Adding new API Operations
An API Client must be capable of handling additional elements in the responses.