Skip to main content

List Customer Tax Exemption Certificates

GET 

/api/customers/:customer/tax-exemption-certificates

List every tax exemption (resale) certificate a customer has on file, newest first — including superseded, rejected and revoked ones, so the full audit trail is visible. Not paginated.

Required scope: customers:read

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

Every certificate carries a computed status (with status_label):

  • valid — approved and in date
  • expiring — approved, and expires_on is within the next 60 days
  • expired — approved, and expires_on has passed
  • lapsed — approved with expiry_rule: lapse_after_inactivity, and 12 months have passed since the customer's last order (lapses_on is the date it lapses)
  • pending — waiting for review
  • rejected, revoked — closed by a reviewer
  • superseded — replaced by an approved renewal (superseded_by_id / superseded_by_number)

review_status is the stored review state (pending, approved, rejected, revoked). days_remaining counts days to expires_on (negative once expired; null without an expiry date). covers_any_state is true for a certificate with no states recorded — such a certificate covers every state until its states are set. document.download_url downloads the attached file. Dates are Y-m-d in the account's timezone; timestamps are ISO-8601 UTC.

Authentication: Requires Bearer token with the customers:read scope. Permission: customers.show.

Request​

Responses​

OK

Response Headers
    Content-Type