KintsugiKintsugi

List customers missing certificates

GET/exemptions/missing-certificates

List the customers who hold an active exemption with no certificate on file, keyset-paginated and sorted by exposure (US exempt sales at risk) with an alphabetical tiebreak, highest first. Scoped to one organization: send an Organization-Id, Connection-Id or Entity-Id selector, or omit it if your credential owns exactly one. Filter to one state with jurisdiction. Pass limit and the opaque cursor from a prior response's nextCursor or previousCursor to page. A cursor is only valid for the jurisdiction filter, the limit, and the organization it was issued under; change any of those and start from the first page.

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.

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.

/exemptions/missing-certificates?jurisdiction=<jurisdiction>&limit=<limit>&cursor=<cursor>
jurisdictionstring

Filter to one state or province code, e.g. CA.

limitinteger

Maximum number of items to return.

cursorstring

Opaque cursor from a prior response's nextCursor or previousCursor. Omit for the first page.

Response

itemsMissingCertificateCustomer[]Required

The customers on this page, highest exposure first.

nextCursorstring

Opaque cursor for the next page. null when this is the last page. Send it back as cursor; do not parse it.

previousCursorstring

Opaque cursor for the previous page. null when this is the first page. Send it back as cursor; do not parse it.

hasMoreboolean

Whether a page exists after this one.

hasPreviousboolean

Whether a page exists before this one.

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 /exemptions/missing-certificates?jurisdiction={jurisdiction}&limit=50&cursor={cursor}
-H "Api-Key: ***"
-H "Api-Version: 2026-07-21"
Example request
https://api.trykintsugi.com/exemptions/missing-certificates?jurisdiction={jurisdiction}&limit=50&cursor={cursor}
Response
{
"items": [
{
"customerId": "cust_2mNpQr7Ls8f3k",
"customerName": "Acme Corp",
"customerEmail": "jane.doe@example.com",
"uncoveredCount": 1,
"totalAmount": "10.00",
"currency": "AED",
"exemptions": [
{
"exemptionId": "exmp_2mNpQr7Ls8f3k",
"jurisdiction": "CA",
"countryCode": "US",
"exemptionType": "customer",
"startDate": "2026-01-01",
"endDate": "2026-12-31",
"source": "NETSUITE",
"totalAmount": "10.00",
"currency": "AED"
}
]
}
],
"nextCursor": "eyJpZCI6InRyYW5fMm1OcFFyN0xzOGYzayJ9",
"previousCursor": "eyJpZCI6InRyYW5fMm1OcFFyN0xzOGYzayJ9",
"hasMore": false,
"hasPrevious": false
}
List customers missing certificates (2026-07-21) | Kintsugi API Reference