Tax Associations

Update tax association

Changed on

Use when changing a tax association (e.g. switch rate or entity). Request body contains the fields to update.

put/taxes/associations/{id}

Request

  • Base URL
    https://us.api.flexprice.io/v1
  • URL
    https://us.api.flexprice.io/v1/taxes/associations/{id}
  • Auth
    API key in header x-api-key

Path parameters

idstring required

Tax Config ID

Request body

auto_applyboolean
metadataobject
priorityinteger
tax_behavior'inclusive' | 'exclusive'

Response

OK

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' | 'credit_note'
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_behavior'inclusive' | 'exclusive'
tax_rate_idstring

Reference to the TaxRate entity

tenant_idstring
updated_atstring date-time
updated_bystring

Changes

  • 3798546cc4a3Revision changes
    • warning

      added the new credit_note enum value to the response property for the response status

  • e1d4e27b5677Revision changes
    • warning

      removed the optional property / from the response with the status

    • info

      added the new optional request property

    • info

      added the optional property to the response with the status

    • info

      removed the fixed enum value from the / response property for the response status