Skip to main content

Get Economic Nexus Exposure

GET 
/api/reporting/sales-tax/nexus

Economic Nexus Monitoring dashboard (Phase 3). Returns one row per destination jurisdiction (state/region) with measured sales and transaction counts compared against that jurisdiction's configured economic-nexus threshold, a computed status, and the percent-of-threshold.

Required scope: reports:read

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

Measured volume is computed per jurisdiction over that jurisdiction's own measurement window (rolling 12 months, calendar year, or previous-or-current calendar year), honouring each threshold's counts_marketplace_sales and counts_exempt_sales flags.

Status values:

  • registered: tenant is registered in the jurisdiction (reported regardless of volume).
  • threshold_met: measured volume meets/exceeds the threshold and the tenant is NOT registered.
  • approaching: measured volume is at or above warning_threshold_percent of the threshold but below it.
  • not_approaching: measured volume is comfortably below the threshold.
  • no_threshold: no threshold configured for the jurisdiction.

Results are read from a per-tenant cache populated by the recompute job; computed_at is the cache timestamp (null if never computed).

Authentication: Requires Bearer token (scope rw:reports).

Request​

Responses​

OK

Response Headers
    Content-Type