Skip to main content
PATCH
Update tax (partial)

Authorizations

X-API-Key
string
header
default:your_tyms_sk_or_partner_key
required

Business secret tyms_sk_... for business-scoped routes. Partner secret for register-business and referred-business distributor routes.

Path Parameters

uuid
string
required

Body

application/json

Send only the fields you want to change. percentage stays a human rate such as 7.5.

name
string

Required. Display name, for example VAT or WHT.

percentage
number

Required. Human rate. Send 7.5 for 7.5 percent, not 0.075.

currency
string

Optional currency code.

is_deduction
boolean

true creates a withholding tax. Default false (sales tax).

payable_account
string

Account name, code, or id. Sales tax: Expenses. Withholding: Liabilities.

receivable_account
string

Account name, code, or id. Sales tax: Liabilities. Withholding: Assets.

Response

Tax updated

status
string
required
Example:

"success"

message
string
required
data
any

Single resource, array of resources, statement sections, or async job metadata — see each operation's example.

meta
object

Pagination (page, limit, total) and/or report range (from, to). Cash flow may include previous_period_end.