Retrieve certificate
Fetch an exemption certificate by ID.
certificate_id from a customer’s exemption.jurisdictions rows, or the id from List certificates.
- A certificate that List certificates leaves out returns
404: one belonging to a deleted customer, or an emailed one not yet linked to a customer. statusisneeds_reviewuntil the certificate is reviewed. It then becomesrejected, with the reason inreview_reason, or a date status:valid,not_yet_activeorexpired.
Authorizations
Path Parameters
Unique identifier for the certificate.
Response
Successful Response
An exemption certificate on file for one of your customers.
Unique identifier for the certificate.
"cexc_01J9Z8Q4E7K2M3N4P5R6S7T8U9"
The customer the certificate belongs to.
"cust_01J9Z8Q4E7K2M3N4P5R6S7T8U9"
The jurisdictions the certificate covers.
valid: approved and in its date window today (UTC). expired: approved and its expiration date has passed. not_yet_active: approved and its start date is in the future. needs_review: not reviewed yet, so it exempts nothing. rejected: reviewed and turned down, so it exempts nothing. More values may be added; treat an unknown one as not valid.
"valid"
Date at which the certificate was created in Taxwire.
"2026-09-14T20:00:00Z"
Date at which the certificate was last updated.
"2026-09-14T20:00:00Z"
The exemption or registration number on the certificate.
"SR-1234567"
The kind of exemption the certificate claims. Null only on a needs_review certificate whose type is not filled in yet.
agriculture, direct_pay, driveaway, govt_exempt_org, manufacturing, resale, other "resale"
The certificate's own description of the exemption. Set only when exemption_type is other.
null
Why the certificate was rejected. Null otherwise.
null
The first day the certificate covers. Null only on a needs_review certificate whose start date is not filled in yet.
"2025-04-01"
The last day the certificate covers. Null when it never expires.
"2027-03-31"