Skip to main content
GET
Retrieve Customer
The 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 expired row and a valid row for the same jurisdiction, so check whether any row for that jurisdiction is valid.
  • updated_at tracks the customer’s own fields and overrides only. A certificate that is added, approved, edited or removed moves exemption.updated_at, not the customer’s own updated_at. An expiry moves neither: it changes a row’s status.
  • valid means 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 overrides but not its certificates, so its jurisdictions can be empty. A customer with merged_into_customer_id set no longer gets new sales.
  • Certificates that are still in review or were rejected do not appear. List certificates returns them.
  • exemption.source_reported_exempt is what the customer’s source system last reported, or null if it has not reported. It never changes how a sale is taxed. See Marking a customer exempt.
See Reading a customer’s exemptions for an example.

Authorizations

X-API-Key
string
header
required

Path Parameters

customer_id
string
required

Unique identifier for the customer.

Response

Successful Response

A customer as GET returns it: the customer plus what exempts it.

id
string
required

Unique identifier for the customer.

Example:

"cust_01J9Z8Q4E7K2M3N4P5R6S7T8U9"

source_id
string
required

Identifier for the customer in the source system.

Example:

"CUS-1042"

source
enum<string>
required

Source system of the customer. taxwire for customers created in Taxwire rather than in another system.

Available options:
business_central,
campfire,
chargebee,
maxio,
measure,
monetizenow,
netsuite,
quickbooks,
ramp,
rillet,
salesbricks,
shopify,
stripe,
taxwire,
xero
Example:

"taxwire"

source_account_id
string
required

Account in the source system that the customer belongs to. __default__ if the source system has no account or tenant ID.

Example:

"__default__"

created_at
string<date-time>
required

Date at which the customer record was created.

Example:

"2026-09-14T20:00:00Z"

updated_at
string<date-time>
required

Date at which the customer record was last updated.

Example:

"2026-09-14T20:00:00Z"

exemption
CustomerExemption · object
required

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.

name
string | null

Name of the customer.

Example:

"Acme Wholesale"

email
string | null

Email address of the customer. Does not need to be unique.

Example:

"ap@acme.example"

merged_into_customer_id
string | null

Unique identifier of the customer this customer was merged into, when the source system reports a merge. null otherwise.

Example:

"cust_01J9ZC4D7F2G8H3J5K6L9M1N0P"

source_updated_at
string<date-time> | null

Date at which the customer was last updated in the source system. null if unknown.

Example:

"2026-09-14T19:58:12Z"