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
| Request | Endpoint | Method | Description |
|---|---|---|---|
| Validate Tax Number | /api/v3/tax_numbers/{tax_id}/validate | GET | This 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/validate | GET | This 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/validate | GET | 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} | GET | This 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