KintsugiKintsugi

Create an exemption request

POST/exemption-requests

Create an exemption-certificate request in the resolved organization and email the customer at customerEmail a link to upload their certificate. customerId links the request to a customer in that organization. Returns 403 FORBIDDEN when the organization is not on a Premium plan. The returned request starts in status SENT with every jurisdiction PENDING_NO_SUBMISSION.

Authorization

Api-KeystringRequired

Your secret API key. Include it with every request.

Headers

Api-Versiondate

Release date, as YYYY-MM-DD. Defaults to 2026-07-21.

Organization-Idstring

Target organization id (Organization-Id selector).

Connection-Idstring

Target connection id; resolves to its organization.

Entity-Idstring

Platform entity id; resolves to a connection's organization.

Entity-Sourcestring

Optional source to disambiguate an Entity-Id.

Body

customerIdstringRequired

Kintsugi customer id to link the request to, in the resolved organization.

customerEmailstringRequired

Email address the exemption-request email is sent to.

jurisdictionsstring[]Required

Uppercase two-letter US state codes the certificate is requested for.

notesForCustomerstring

Optional note included in the email to the customer.

Response

idstringRequired

Kintsugi's unique identifier for the exemption request.

organizationIdstringRequired

Organization the exemption request belongs to. Send it as Organization-Id to scope a request to this exemption request.

customerIdstringRequired

Kintsugi customer id the request is for.

customerNamestringRequired

Display name of the linked customer, or null when the customer has no name or has been deleted.

customerCompanyNamestringRequired

Company name of the linked customer, or null when unset.

customerEmailstringRequired

Email address the request was sent to.

jurisdictionsExemptionRequestJurisdiction[]Required

Requested states, each with its derived per-jurisdiction progress.

notesForCustomerstringRequired

Note included in the email to the customer, or null when none.

statusPublicExemptionRequestStatusEnumRequired

Rolled-up lifecycle status of the request.

Available options:SENTIN_REVIEWPARTIALLY_COMPLETEDCOMPLETEDREJECTEDCANCELLED
emailSendStatusPublicEmailSendStatusEnumRequired

Delivery status of the request's most recent customer email.

Available options:PENDINGSENTFAILED
expiresAtstringRequired

When the customer's upload link expires, as an RFC-3339 UTC timestamp.

createdAtstringRequired

When the request was created, as an RFC-3339 UTC timestamp.

resentAtstringRequired

When the request's upload link was last resent, or null if it has not been resent.

201

Successful Response

400

The request was invalid.

401

Authentication failed or was missing.

403

The credential is not permitted for this request.

404

The requested resource was not found.

409

The request conflicts with existing state.

422

The request failed validation.

cURL
POST /exemption-requests
-H "Api-Key: ***"
-H "Api-Version: 2026-07-21"
{
"customerId": "cust_2mNpQr7Ls8f3k",
"customerEmail": "buyer@example.com",
"jurisdictions": [
"CA",
"NY"
],
"notesForCustomer": "Please upload your resale certificate."
}
Response
{
"id": "exrq_2mNpQr7Ls8f3k",
"organizationId": "orgn_2mNpQr7Ls8f3k",
"customerId": "cust_2mNpQr7Ls8f3k",
"customerName": "Acme, Inc.",
"customerCompanyName": "Acme Holdings LLC",
"customerEmail": "buyer@example.com",
"jurisdictions": [
{
"state": "CA",
"chipState": "PENDING_NO_SUBMISSION"
}
],
"notesForCustomer": "Please upload your resale certificate.",
"status": "SENT",
"emailSendStatus": "PENDING",
"expiresAt": "2026-09-28T12:00:00Z",
"createdAt": "2026-07-28T12:00:00Z",
"resentAt": "2026-07-28T12:00:00Z"
}
Create an exemption request (2026-07-21) | Kintsugi API Reference