v52

latestOpenAPI 3.0.1AGPL-3.0raw.githubusercontent.com2026-08-01255473862.7 KB

Tax Associations

Create Tax Association

Use when linking a tax rate to an entity (e.g. customer, product, or region) so that rate applies on invoices.

post/taxes/associations

auto_applyboolean

currencystring

end_datestring date-time

EndDate sets when this association expires. Must be after StartDate when both are provided.

entity_idstring

entity_type'customer' | 'subscription' | 'invoice' | 'tenant'

external_customer_idstring

metadataobject

priorityinteger

start_datestring date-time

StartDate sets when this association becomes active. Defaults to now if omitted.

tax_rate_codestring required

auto_applyboolean

Whether this tax should be automatically applied

created_atstring date-time

created_bystring

currencystring

Currency

end_datestring date-time

EndDate is the optional date until which this association is active

entity_idstring

ID of the entity this tax rate applies to

entity_type'customer' | 'subscription' | 'invoice' | 'tenant'

environment_idstring

EnvironmentID is the ID of the environment this tax rate config belongs to

idstring

ID of the ent.

metadataobject

Metadata holds the value of the "metadata" field.

priorityinteger

Priority for tax resolution (lower number = higher priority)

start_datestring date-time

StartDate is the date from which this association is active

status'published' | 'deleted' | 'archived'

tax_rate_idstring

Reference to the TaxRate entity

tenant_idstring

updated_atstring date-time

updated_bystring