KintsugiKintsugi

List a nexus's exposure history

GET/nexus/{nexus_id}/exposure-history

List the recorded exposure changes for a nexus, such as its collected tax reaching zero. Searches every organization your credential owns, so no selector is needed for a known id.

Returns 404 if the nexus does not exist or belongs to an organization your credential cannot access, so the API never confirms an id exists. A nexus with no recorded changes returns an empty list.

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.

Path parameters

nexus_idstringRequired

The unique identifier of the nexus.

Response

idstringRequired

Opaque unique identifier for this event.

statestringRequired

State or province code the event was recorded for.

eventTypePublicNexusExposureEventTypeEnumRequired

What kind of exposure change this event records. Ignore unrecognized values.

Available options:NET_COLLECTED_TAX_ZEROED_OUT
reasonstringRequired

Human-readable explanation of why the event was recorded.

netTaxstringRequired

Net collected tax at the time of the event, as a decimal string. This is totalCollected minus totalRefunded.

totalCollectedstringRequired

Total tax collected at the time of the event, as a decimal string.

totalRefundedstringRequired

Total tax refunded at the time of the event, as a decimal string.

timestampstringRequired

When the exposure change the event records took effect, as an RFC-3339 UTC timestamp.

createdAtstringRequired

When this event row was written, as an RFC-3339 UTC timestamp.

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 /nexus/{nexus_id}/exposure-history
-H "Api-Key: ***"
-H "Api-Version: 2026-07-21"
Example request
https://api.trykintsugi.com/nexus/{nexus_id}/exposure-history
Response
[
{
"id": "3f6c2b1e-8a4d-4c2e-9b1f-2d7e5a6c9f10",
"state": "CA",
"eventType": "NET_COLLECTED_TAX_ZEROED_OUT",
"reason": "Customer request",
"netTax": "0.00",
"totalCollected": "100.00",
"totalRefunded": "100.00",
"timestamp": "2026-07-28T12:00:00Z",
"createdAt": "2026-07-28T12:00:00Z"
}
]
List a nexus's exposure history (2026-07-21) | Kintsugi API Reference