Skip to main content

Update Tax Exemption Certificate

PUT 

/api/tax-exemption-certificates/:certificate

Edit a certificate that is still pending review. Send only the fields to change; omitted fields keep their current values. Sending states replaces the full list of covered states. Once a certificate is approved, rejected or revoked it can no longer be edited — renew it instead (422).

Required scope: customers:write

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

Accepts every field of Create Customer Tax Exemption Certificate except file and approve_now (use Replace Tax Exemption Certificate Document and Approve Tax Exemption Certificate). Send an empty string to clear an optional field.

Fields:

  • certificate_number (string, required, max 100)
  • exemption_type (required): resale, nonprofit, government, manufacturing, agricultural, other
  • form_type (required): state_specific (a state's own form), sst (Streamlined Sales Tax multistate), mtc (MTC uniform), other
  • form_code (string, optional, max 60) — the form's own code, e.g. 01-339 or DR-13
  • issued_on (date Y-m-d, optional)
  • expires_on (date Y-m-d, optional, on or after issued_on)
  • expiry_rule (required): fixed_date (expires on expires_on), annual (renews every year), never, lapse_after_inactivity (lapses after 12 months without a purchase)
  • states — the US state codes the certificate covers (at least one; two-letter codes, e.g. TX, FL, DC). In multipart requests send states[] once per state, or one comma-separated states value.
  • external_url (URL, optional, max 2048) — a link to the certificate held elsewhere, instead of or as well as a file
  • notes (string, optional, max 5000)
  • verification_status (optional): pending, verified, mismatch, unverifiable, manual_check_needed, no_certificate, not_applicable — the outcome of a state registry lookup you ran yourself
  • verification_payload (JSON string, optional) — the raw lookup result to keep alongside it

Combination rules (422 on violation): the MTC uniform certificate (form_type: mtc) can only be used for resale; Maryland, Hawaii and the District of Columbia (MD, HI, DC) accept no multistate (sst / mtc) certificate — ask for the state's own form.

Authentication: Requires Bearer token with the customers:write scope. Permission: customers.update.

Request​

Responses​

OK

Response Headers
    Content-Type