Vertex Validator API Requests

Use these requests to validate tax numbers in the validation service.

Here's a list of requests to validate tax numbers in:

  • Vertex O Series Cloud Online Commerce
  • Standalone Vertex Validator
RequestEndpointMethodDescription
Validate Tax Number/api/v3/tax_numbers/{tax_id}/validateGETThis request validates a tax number and supports country-specific validation, business name verification, and configurable cache settings to control whether the service uses recent validation results or performs a real-time check against the tax authority's database.
Bulk Validate Tax Numbers/bulk/api/v3/tax_numbers/validateGETThis request validates multiple tax numbers in a single request by submitting a list of tax numbers and their associated country codes in the request body.
Poll Results/bulk/api/v3/tax_numbers/validateGET

This request retrieves the status and results of the Bulk Validate Tax Numbers request. It monitors processing progress, checks how many tax numbers have been validated, or retrieves previously submitted results.

A response returns up to 100 validation results.

Poll Last Seen Result/bulk/api/v3/tax_numbers/validate?{last-seen-id}GETThis request retrieves newly processed tax number validation results using the last-seen tax number from a previous response.

For more information about the fields in the reports and their descriptions, see Vertex Validator API Field References