Skip to main content
GET
Retrieve Certificate
Returns one exemption certificate. Use the 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.
  • status is needs_review until the certificate is reviewed. It then becomes rejected, with the reason in review_reason, or a date status: valid, not_yet_active or expired.

Authorizations

X-API-Key
string
header
required

Path Parameters

certificate_id
string
required

Unique identifier for the certificate.

Response

Successful Response

An exemption certificate on file for one of your customers.

id
string
required

Unique identifier for the certificate.

Example:

"cexc_01J9Z8Q4E7K2M3N4P5R6S7T8U9"

customer_id
string
required

The customer the certificate belongs to.

Example:

"cust_01J9Z8Q4E7K2M3N4P5R6S7T8U9"

jurisdictions
CertificateJurisdiction · object[]
required

The jurisdictions the certificate covers.

status
string
required

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.

Example:

"valid"

created_at
string<date-time>
required

Date at which the certificate was created in Taxwire.

Example:

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

updated_at
string<date-time>
required

Date at which the certificate was last updated.

Example:

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

exemption_number
string | null

The exemption or registration number on the certificate.

Example:

"SR-1234567"

exemption_type
enum<string> | null

The kind of exemption the certificate claims. Null only on a needs_review certificate whose type is not filled in yet.

Available options:
agriculture,
direct_pay,
driveaway,
govt_exempt_org,
manufacturing,
resale,
other
Example:

"resale"

exemption_type_other
string | null

The certificate's own description of the exemption. Set only when exemption_type is other.

Example:

null

review_reason
string | null

Why the certificate was rejected. Null otherwise.

Example:

null

starts_at
string<date> | null

The first day the certificate covers. Null only on a needs_review certificate whose start date is not filled in yet.

Example:

"2025-04-01"

expires_at
string<date> | null

The last day the certificate covers. Null when it never expires.

Example:

"2027-03-31"