Update an exemption
Update an exemption in the resolved organization. Only the fields you send are applied; send endDate as null to remove an expiry. customerId, exemptionType, countryCode and jurisdiction cannot be changed, since they define which exemption this is: create a new exemption instead. An exemption that is or becomes ACTIVE has the transactions it covers requeued for tax recalculation, which happens after this call returns.
Authorization
Headers
Release date, as YYYY-MM-DD. Defaults to 2026-07-21.
Target organization id (Organization-Id selector).
Target connection id; resolves to its organization.
Platform entity id; resolves to a connection's organization.
Optional source to disambiguate an Entity-Id.
Path parameters
The unique identifier of the exemption.
Body
First day the exemption is in force, as YYYY-MM-DD. Omit or send null to leave unchanged.
Last day the exemption is in force, as YYYY-MM-DD. Omit to leave unchanged. Send null to remove the expiry. Must not precede the exemption's startDate.
Whether the exemption is claimed on the basis of resale. Omit or send null to leave unchanged; send true or false to replace.
Federal Employer Identification Number to record. Omit or send null to leave unchanged; send a value to replace. This PATCH cannot clear a stored FEIN.
Sales tax registration number to record. Omit or send null to leave unchanged; send a value to replace. This PATCH cannot clear a stored sales tax id.
Lifecycle status to move the exemption to. Only ACTIVE exemptions are applied by tax calculation. Omit or send null to leave unchanged.
ACTIVEINACTIVEEXPIREDDEACTIVATEDOptional client-minted id for this confirm attempt. When present, duplicate submits of the same gesture can be grouped.
Response
Kintsugi's unique identifier for the exemption.
Organization the exemption belongs to. Send it as Organization-Id to scope a request to this exemption.
Customer the exemption is held against. null for an exemption recorded against a transaction alone.
Display name of the customer the exemption is held against, resolved when you list or fetch an exemption. null for an exemption recorded against a transaction alone (no customer). Sort a list by it with sort=customerName.
Transaction the exemption applies to. null when it applies to the customer's transactions generally rather than to one of them.
What the exemption applies to.
customerwholesaletransactionreverse_chargepartialPartial-exemption form code, such as CDTFA-230-M. Required when exemptionType is partial. Null for every other exemption type.
Lifecycle status. Only ACTIVE exemptions are applied by tax calculation; the others are retained for reporting.
ACTIVEINACTIVEEXPIREDDEACTIVATEDARCHIVEDISO 3166-1 alpha-2 country the exemption is scoped to. null when it is not scoped to one country.
State or province code the exemption is scoped to, within countryCode. null when it covers the whole country.
First day the exemption is in force, as YYYY-MM-DD.
Last day the exemption is in force, as YYYY-MM-DD. null when it does not expire.
Whether the exemption is claimed on the basis of resale.
Federal Employer Identification Number recorded on the exemption. An empty string when none was recorded.
Sales tax registration number recorded on the exemption. An empty string when none was recorded.
Origin system the exemption was recorded from. null for an exemption recorded before origins were tracked.
NETSUITEQUICKBOOKSINTUIT_ENTERPRISE_SUITESAGE_INTACCTSHOPIFYXEROSTRIPEBIGCOMMERCEMAGENTOMAXIOCHARGEBEEZUORAMICROSOFT_DYNAMICS_365DUALENTRYRECURLYSHOPLINEORBZENSKARHYPERLINEODOOMANUALBULK_UPLOADEMAILCHECKOUTAPIMISSING_CERTIFICATEWhether any certificate document is on file for the exemption. Equivalent to certificates being non-empty, published so a list view does not have to walk the array.
Certificate documents on file, most recent first. An empty list when there are none.
The owning customer's display fields. Absent unless the request passes expand=customer; when expanded it is always an object (never null), though customerName and companyName may each be null.
Successful Response
The request was invalid.
Authentication failed or was missing.
The credential is not permitted for this request.
The requested resource was not found.
The request conflicts with existing state.
The request failed validation.