Fields Reference

This topic lists the fields that you can use with the API request.

Request fields

FieldDescription
customer.taxRegistrations.isoCountryCodeThis is the ISO code that represents the country to which the registration belongs. This is sometimes added to the Tax ID (as a prefix) for countries that require this.
customer.taxRegistrations.taxRegistrationNumberThis is the Tax ID that the Accelerator will validate. When this value is prefixed (with the country code) and the ID is valid, for example IE12345 and the value in the isoCountryCode field is not specified or is not a valid code, the prefix is used to specify the country that the Tax ID belongs to.
customer.taxRegistrations.taxRegistrationTypeThis is the type of Tax Scheme to which the ID belongs, like VAT. You must specify VAT Registration. Other values will not work.

Response fields

FieldDescription
isValidBoolean that indicates if the Tax ID is valid or not.
isSyntaxValidIndicates whether the syntax is correct.
validationInfoMore detailed information about the processing.
normalizedTaxRegistrationNumberThe Tax ID in the standardized format.
cachedIndicates whether a cached validation was used or note.
cacheTimestampIf a cached value is returned, this field shows the time that the initial request was sent to the external service.
nameThe name that is associated with the Tax ID. Where available, this is retrieved from the Tax Authority's database.
freeformAddressThe address that is associated with the Tax ID. Where available, this is retrieved from the Tax Authority's database.
customer.customercode.isBusinessIndicatorIf the Tax ID is valid, this will be set to true in the response, indicating that the customer is a business.