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.