Retrieve customer
Returns a single customer by its Taxwire id. Answers 404 for an unknown id, one owned by another organization, or one deleted in the Taxwire app.
Authorizations
Path Parameters
The customer's Taxwire id (a cust_-prefixed ULID).
Response
Successful Response
A customer: who is buying. Exemptions set in the app hang off it.
Taxwire's stable identifier for the customer.
"cust_01J9Z8Q4E7K2M3N4P5R6S7T8U9"
Your identifier for the customer in the system it came from. Pass it as customer.preset.id on a calculation to name this customer.
"CUS-1042"
"td3106586:1042"
The system the customer came from. taxwire for customers you send directly to this API.
business_central, campfire, maxio, monetizenow, netsuite, quickbooks, rillet, salesbricks, shopify, stripe, taxwire, xero "taxwire"
"netsuite"
The account the customer belongs to within source, as Taxwire's customer sync stores it. __default__ when the customer is stored without one: today that's every source except quickbooks and xero.
"__default__"
"9130349283746"
When Taxwire first stored the customer.
"2026-09-14T20:00:00Z"
When the customer was last changed in Taxwire. Equals created_at until the first change.
"2026-09-14T20:00:00Z"
The customer's display name.
"Acme Wholesale"
The customer's email. Not unique: several customers can share one inbox.
"ap@acme.example"
Set when the source system merged this customer into another; the id of the surviving customer. Null otherwise.
null
When the customer last changed in the source system, as reported by the sender. Null when unknown.
"2026-09-14T19:58:12Z"