API reference
Tax identities
Customer API: GET /tax-identities, PUT /tax-identities, DELETE /tax-identities/{id}
One per country and type, with the verification status against the public registry where one exists.
Response 200
taxIdentitiesobject[]requiredtaxIdentities[].idstringrequiredtaxIdentities[].countrystringrequiredtaxIdentities[].typestringrequiredtaxIdentities[].valuestringrequiredAs entered.
taxIdentities[].normalizedstringrequiredtaxIdentities[].status"PENDING" | "VALID_FORMAT" | "VERIFIED" | "NOT_FOUND" | "UNAVAILABLE" | "INVALID_FORMAT"requiredVerification against the public registry; informational only.
taxIdentities[].namestring | nullrequiredtaxIdentities[].addressstring | nullrequiredtaxIdentities[].registryNamestring | nullrequiredName recorded by the registry when VERIFIED.
taxIdentities[].registryStatusstring | nullrequiredtaxIdentities[].attributionobject | nullrequiredOpen-data attribution to show next to registry data.
taxIdentities[].attribution.providerstringtaxIdentities[].attribution.providerEnstringtaxIdentities[].attribution.dataDatestring
curl -X GET "https://{site}/api/v1/customer/tax-identities" \
-H "Authorization: Bearer $KANORIO_CUSTOMER_TOKEN"Keyed by country and type (type defaults to the country's first registered type). Format and checksum follow the shared business-registry rules; a changed number is re-verified asynchronously. Verification results are informational and never block checkout.
Request body
countrystringrequiredISO 3166-1 alpha-2.
typestring | nullTax ID type (for example tw_vat, jp_trn, eu_vat); defaults to the country's first registered type.
valuestringrequirednamestring | nullRegistered name for invoices.
addressstring | nullRegistered address for invoices.
Response 200
taxIdentityobjectrequiredtaxIdentity.idstringrequiredtaxIdentity.countrystringrequiredtaxIdentity.typestringrequiredtaxIdentity.valuestringrequiredAs entered.
taxIdentity.normalizedstringrequiredtaxIdentity.status"PENDING" | "VALID_FORMAT" | "VERIFIED" | "NOT_FOUND" | "UNAVAILABLE" | "INVALID_FORMAT"requiredVerification against the public registry; informational only.
taxIdentity.namestring | nullrequiredtaxIdentity.addressstring | nullrequiredtaxIdentity.registryNamestring | nullrequiredName recorded by the registry when VERIFIED.
taxIdentity.registryStatusstring | nullrequiredtaxIdentity.attributionobject | nullrequiredOpen-data attribution to show next to registry data.
taxIdentity.attribution.providerstringtaxIdentity.attribution.providerEnstringtaxIdentity.attribution.dataDatestringcreatedboolean
Errors
VALIDATION400INVALID_TAX_ID400UNSUPPORTED_COUNTRY400
curl -X PUT "https://{site}/api/v1/customer/tax-identities" \
-H "Authorization: Bearer $KANORIO_CUSTOMER_TOKEN" \
-H "Content-Type: application/json" \
-d '{}'curl -X DELETE "https://{site}/api/v1/customer/tax-identities/{id}" \
-H "Authorization: Bearer $KANORIO_CUSTOMER_TOKEN"