Set the tax number
Replaces the tax number on file, filed under the type the
organization's country uses. An empty tax_id removes it. To
change the address or entity type too, set the billing details
instead.
Answers with the tax details as saved.
Requires the billing:profile:write scope.
Authorization
Request body required
tax_idstringThe tax registration number, or""to remove it.
Responses
200
The tax details as saved.
dataTaxDetailsShow TaxDetails properties
countrystringtax_idstringtax_id_typestringLeft out when there is no number.editablebooleanWhether a tax number can be filed for this country.
400
The body is not JSON (INVALID_BODY), or the number was not accepted — usually one that does not match its country's format (TAX_ID_REJECTED).
errorobject requiredcodestring requiredmessagestring requiredrequest_idstring
401
No API key was sent, or it is unknown, revoked or expired (UNAUTHORIZED).
errorobject requiredcodestring requiredmessagestring requiredrequest_idstring
403
The key lacks the scope this endpoint needs (FORBIDDEN).
errorobject requiredcodestring requiredmessagestring requiredrequest_idstring
409
No billing details or card have been saved yet (NO_PAYMENT_SETUP),
or a number was given while the organization's country is not
known (COUNTRY_UNKNOWN) — set the billing details first.
errorobject requiredcodestring requiredmessagestring requiredrequest_idstring
429
Too many requests (RATE_LIMITED). Wait for Retry-After seconds.
Retry-AfterintegerSeconds to wait before retrying.
errorobject requiredcodestring requiredmessagestring requiredrequest_idstring
503
Payments are not enabled on this environment (PAYMENTS_DISABLED).
errorobject requiredcodestring requiredmessagestring requiredrequest_idstring
Example request
curl -X PUT 'https://evohub.io/api/v1/billing/tax-details' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
-d '{
"tax_id": "IE1234567T"
}'
