Standalone Vertex Validator

One of the options for using Vertex Validator is as a standalone component. This is where you solely use Vertex Validator and do not use Vertex Advantage or other products. For example, some customers may want to integrate supplier verification into their supplier onboarding process.

To facilitate this type of integration, you use the Validate VAT Number request.

Dashboard Access

You need to contact support to get a user before you can integrate with the service. After you get this user, log in to the Merchant Portal and retrieve your access token. You will need this to be able to make requests. You can also later changes settings in the UI if needed. See Retrieving Access Tokens.


Process Flow

The following diagram shows a typical process flow for a standalone integration:

The steps are as follows:

  1. A Tax ID is sent to the service for validation. It is specified in the URL of a Validate VAT Number request.
  2. The service validates the Tax ID, using the cache of previously approved IDs or the Tax Authority's database. This depends on your settings. See VAT Status Cache.
  3. The request's response contains information about whether the ID is valid and some other useful information. See Vertex Validator Output Schema.

API Integration

To integrate the service, you use the Validate VAT number request. See Validate VAT number.

To use this request, send a GET operation to the following endpoint URL:{tax-number}/validate?{country_code}


  • {tax-number} is the Tax ID that you want to verify.
  • {country_code} is the country where the ID originates.

The following table lists the parameters that you can include with the the request:

private_tokenPrivate token.
tax_numberThe Tax ID that you wish to validate.
country_codeThe code for the country. Note that for some Canadian provinces like Quebec, you must prefix the number with CA.


Useful validation information is returned by the API. See Vertex Validator Output Schema.

In some cases, this information can be redacted. See Redacted Responses.