Retrieve customer
Fetch a customer by ID. Includes the customer’s exemption block; only exemption.overrides.exempt and exemption.source_reported_exempt can be written.
exemption block says what exempts the customer today. exemption.overrides mirrors the customer’s switches. exemption.jurisdictions has one row per approved certificate per jurisdiction it covers.
- The block is a snapshot as of now. It does not promise that a given sale is exempt, because the product and the sale date also decide whether a certificate applies.
- Rows are not grouped. A renewed certificate shows an
expiredrow and avalidrow for the same jurisdiction, so check whether any row for that jurisdiction isvalid. updated_attracks the customer’s own fields and overrides only. A certificate that is added, approved, edited or removed movesexemption.updated_at, not the customer’s ownupdated_at. An expiry moves neither: it changes a row’sstatus.validmeans today (UTC) is inside the certificate’s dates. It does not mean Taxwire applies the certificate: that needs exemption management on for your organization and a Taxwire rule for the certificate’s type and place.- When the source system merges two customers, new sales go to the customer that remains. It keeps the merged customer’s
overridesbut not its certificates, so itsjurisdictionscan be empty. A customer withmerged_into_customer_idset no longer gets new sales. - Certificates that are still in review or were rejected do not appear. List certificates returns them.
exemption.source_reported_exemptis what the customer’s source system last reported, ornullif it has not reported. It never changes how a sale is taxed. See Marking a customer exempt.
Response
Successful Response
A customer as GET returns it: the customer plus what exempts it.
Source system of the customer. taxwire for customers created in Taxwire rather than in another system.
business_central, campfire, chargebee, maxio, measure, monetizenow, netsuite, quickbooks, ramp, rillet, salesbricks, shopify, stripe, taxwire, xero "taxwire"
What exempts this customer as of now. Only overrides.exempt and the source's own source_reported_exempt can be written, on create, update and batch. updated_at tracks the customer's own fields and overrides only. Certificate changes move exemption.updated_at instead, and an expiry moves neither: it changes a row's status.