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 for e-Commerce 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.

You can also use the Bulk Tax ID Validations feature to validate a batch of IDs.

UI 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.

Notes

• You can only validate one Tax ID per Validate VAT number request.
• You need to enable the Tax calculation setting in the UI for each region whos Tax IDs you want to validate. See Country Settings.

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:

https://services.taxamo.com/api/v2/tax/vat_numbers/{tax-number}/validate?{country_code}

where:

• {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:

Responses

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

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