Resolve a nexus's collected-tax exposure
Clear the collected-tax exposure on a nexus and schedule a recalculation. Send an Organization-Id, Connection-Id or Entity-Id selector to say which organization it belongs to. The request body is optional; omit it, or send an empty object, for the default resolve. When present, requestId identifies this confirm attempt so duplicate submits of the same gesture can be grouped.
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. Returns 400 if your credential has no user identity to attribute the resolve to.
Authorization
Headers
Release date, as YYYY-MM-DD. Defaults to 2026-07-21.
Target organization id (Organization-Id selector).
Target connection id; resolves to its organization.
Platform entity id; resolves to a connection's organization.
Optional source to disambiguate an Entity-Id.
Path parameters
The unique identifier of the nexus.
Body
Optional client-minted id for this confirm attempt. When present, duplicate submits of the same gesture can be grouped.
Response
Opaque unique identifier for this nexus.
Organization this nexus belongs to. Always present so a portfolio list that spans organizations stays unambiguous.
Display name of the owning organization. null if the name could not be loaded.
ISO 3166-1 alpha-2 country of the jurisdiction.
State or province code within countryCode. FD for a federal jurisdiction.
Display name of the state or province.
Lifecycle state of this nexus determination. Ignore unrecognized values.
EXPOSEDAPPROACHINGPENDING_REGISTRATIONOSS_PENDING_REGISTRATIONREGISTEREDOSS_REGISTEREDNOT_EXPOSEDKind of jurisdiction. CANADA_FEDERAL is the wire value for every federal jurisdiction, not only Canada. Ignore unrecognized values.
CANADA_FEDERALEU_AGGREGATOREU_IOSSSTATEEU_MEMBER_STATETax obligation this row tracks. Sales and use are separate rows. Ignore unrecognized values.
SALES_TAXUSE_TAXRETAIL_DELIVERY_FEEVolume the jurisdiction counts toward its threshold. Ignore unrecognized values.
EITHERSALESBOTHTRANSACTIONSHow the jurisdiction measures the economic-nexus lookback window. Ignore unrecognized values.
CURRENT_OR_PREVIOUSCURRENT_OR_TWO_PREVIOUSPRECEDING_YEAR_FROM_OCTOBERCALENDAR_YEARPREVIOUS_12_MONTHSCURRENT_OR_PREVIOUS_12_MONTHSPREVIOUS_4_QUARTERSPREVIOUS_4_QUARTERS_OFFSETPRECEDING_YEARPRECEDING_YEAR_QUARTERLYPRECEDING_YEAR_QUARTERLY_OFFSETISO-4217 currency of the amount fields on this row.
Sales threshold as a decimal string in currency.
If the jurisdiction has no transaction-count threshold, this is null.
Transaction count in the current measurement window. For CURRENT_OR_* period models, the greater of the current and previous windows.
Sales amount in the current measurement window, as a decimal string in currency. For CURRENT_OR_* period models, the greater of the current and previous windows.
Whether economic nexus has been met in this jurisdiction.
Whether physical nexus has been met in this jurisdiction.
Whether nexus has been met by collecting tax in this jurisdiction.
Date economic nexus was met. null if it has not been met.
Date physical nexus was met. null if it has not been met.
Date collected-tax nexus was met. null if it has not been met.
Date the tax obligation began in this jurisdiction: the earliest of the economic met date, the physical met date where the jurisdiction counts it, and the registration or importer-of-record collection start. Collected-tax nexus does not contribute. null if no obligation has begun.
Tax liability Kintsugi calculated for this jurisdiction, as a decimal string in currency.
Tax already collected on imported transactions in this jurisdiction, as a decimal string in currency. Distinct from taxLiability, which is what Kintsugi calculated.
Whether this nexus is currently disregarded: it was disregarded and has had no new nexus activity since. A disregarded nexus that later crosses a threshold again reads as false.
When this nexus was disregarded, as an RFC-3339 UTC timestamp. null if it was never disregarded. Stays set after later activity re-exposes the nexus, so it records that a disregard happened rather than that one is in effect; read isCurrentlyDisregarded for the latter.
Which kinds of nexus had already been met at the moment this nexus was disregarded. Empty if it was never disregarded. Ignore unrecognized values.
ECONOMICPHYSICALCOLLECTED_TAXWhether this nexus qualifies to be taken through a Voluntary Disclosure Agreement, based on its exposure age and liability. Being eligible does not mean one is under way; read vdaEligible for that.
Whether Kintsugi has flagged this nexus as already being handled through a Voluntary Disclosure Agreement. Registering normally is not available while this is true.
Whether this jurisdiction still needs an Importer of Record number after registration completes. false unless the organization sells physical goods into the jurisdiction and has no physical presence there.
Whether the organization may decline to act as Importer of Record for this nexus. Requires an exposed, not-yet-disregarded nexus in a jurisdiction that supports IOR.
When this nexus row was created, as an RFC-3339 UTC timestamp.
When this nexus row was last updated. null if it was never updated.
Measurement windows for this nexus, most recent first. Empty if none are stored.
Start of the current measurement window. null if not yet established.
End of the current measurement window. null if not yet established.
Start of the previous measurement window. null if there is no previous window.
End of the previous measurement window. null if there is no previous window.
Transaction counts summed across the windows in periods, so this reconciles with those windows rather than with any window the response omits.
Why this nexus is disregarded. null if it is not disregarded. Ignore unrecognized values.
DISREGARDEDIOR_OPT_OUTIOR_OPT_OUT_NON_PHYSICAL_GOODSSuccessful Response
The request was invalid.
Authentication failed or was missing.
The credential is not permitted for this request.
The requested resource was not found.
The request conflicts with existing state.
The request failed validation.