KintsugiKintsugi

List exemption requests

GET/exemption-requests

List exemption requests, newest first. Covers every organization your credential owns; send an Organization-Id, Connection-Id or Entity-Id selector to narrow to one. Optional status filters by lifecycle status, and optional jurisdiction (a two-letter US state code) returns only requests that include it. Returns an empty list when there are no matching requests.

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

Narrow the request to one organization (Organization-Id selector).

Connection-Idstring

Narrow the request to a connection's organization.

Entity-Idstring

Narrow the request to a platform entity's organization.

Entity-Sourcestring

Optional source to disambiguate an Entity-Id.

Query

Every query parameter below is optional. Combine as many as you need and append them to the endpoint as a query string. The example shows a few to get you started.

/exemption-requests?status=<status>&jurisdiction=<jurisdiction>
statusstring

Filter by lifecycle status; returns only requests in that status.

jurisdictionstring

Two-letter US state code. Returns only requests whose jurisdictions include this state.

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.

200

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
GET /exemption-requests?status={status}&jurisdiction={jurisdiction}
-H "Api-Key: ***"
-H "Api-Version: 2026-07-21"
Example request
https://api.trykintsugi.com/exemption-requests?status={status}&jurisdiction={jurisdiction}
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"
}
]
List exemption requests (2026-07-21) | Kintsugi API Reference