Upsert a customer tax registration by tax id
Create or update a tax registration. Send countryCode and taxType together to validate taxId against that pair; omit both to derive from taxId and the customer's country. Always 200. 400 if taxId is invalid, mismatched, or only one field is sent. 404 if the customer doesn't exist.
Authorization
Headers
Release date, as YYYY-MM-DD. Defaults to 2026-07-21.
Target organization id (Organization-Id selector).
Target connection id; resolves to its organization.
Platform entity id; resolves to a connection's organization.
Optional source to disambiguate an Entity-Id.
Path parameters
The unique identifier of the customer.
Body
The tax registration number. When countryCode and taxType are both omitted, they are derived from this value together with the customer's own country.
Country the registration is valid in, ISO 3166-1 alpha-2. Send this together with taxType to validate taxId against an explicit pair instead of deriving one.
Kind of tax the registration is for. Send this together with countryCode.
gsthstgst_hstqstpstrstvatunknownResponse
Kintsugi's unique identifier for the registration.
Country the registration is valid in, ISO 3166-1 alpha-2.
Kind of tax the registration is for.
gsthstgst_hstqstpstrstvatunknownThe tax registration number itself.
Whether the tax id passed validation for its country and type. Derived by Kintsugi; not accepted on write.
Successful Response
The request was invalid.
Authentication failed or was missing.
The credential is not permitted for this request.
The requested resource was not found.
The request conflicts with existing state.
The request failed validation.