List nexus determinations
Returns a keyset page of nexus determinations for organizations your credential owns. Send Organization-Id, Connection-Id, or Entity-Id to narrow to one organization. A cursor is valid only for the filters and organization scope that issued it. Period history is omitted; get a nexus by ID for typed periods.
Authorization
Headers
Release date, as YYYY-MM-DD. Defaults to 2026-07-21.
Narrow the request to one organization (Organization-Id selector).
Narrow the request to a connection's organization.
Narrow the request to a platform entity's organization.
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.
/nexus?status=<status>&disregarded=<disregarded>&collectedTaxNexusMet=<collectedTaxNexusMet>Comma-separated lifecycle statuses. Matches any listed value.
Comma-separated ISO 3166-1 alpha-2 country codes. Matches any listed value.
Comma-separated state or province codes. Matches any listed value.
Comma-separated tax types. Matches any listed value.
Which disregard state to return. CURRENT returns rows where isCurrentlyDisregarded is true; NONE returns rows where it is false; EVER returns every row that carries a disregardedAt, including ones later activity re-exposed. Omit for no disregard filter.
NONECURRENTEVERFilter on whether nexus was met by collecting tax in the jurisdiction. Passing true also lifts the default collected-tax-only exclusion, so collectedTaxOnly is unnecessary alongside it.
Include exposed rows whose only nexus is collected tax. These are hidden by default because collecting tax is not itself an economic or physical exposure.
Drop EU member-state rows whose only nexus is economic. Those obligations are represented by the ZZ_EU aggregator row, so listing both counts one obligation twice.
Case-insensitive match on state code or state name.
Maximum number of items to return.
Opaque cursor from a prior response's nextCursor or previousCursor. Omit for the first page.
Response
Nexus rows on this page.
Opaque cursor for the next page. null on the last page. Send it back as cursor; do not parse it.
Opaque cursor for the previous page. null on the first page. Send it back as cursor; do not parse it.
Whether a page exists after this one.
Whether a page exists before this one.
Successful 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.