List jurisdictions

One item per jurisdiction the account touches, country and state level: one with a registration (requested, in progress or complete), with tax collection set up, or with nexus activity. Each item carries the resolved nexus exposure (nexus) and the registration state (registration, null when the account has no registration there). Sorted by jurisdiction code, not paginated. nexus_study says where the account is on the road to a finished economic nexus study, so callers never have to infer it from the rows.

To check whether Taxwire collects tax in a jurisdiction now, read is_collecting on its item. With no item, or is_collecting false, calculations return zero tax there. Don’t infer it from nexus.status, registration.status or the collection dates.

GET /jurisdictions

List Jurisdictions

cURL

curl --request GET \
  --url https://api.taxwire.com/jurisdictions \
  --header 'X-API-Key: <api-key>'

200

{
  "has_more": true,
  "nexus_study": {
    "status": "COMPLETE",
    "completed_at": "2026-09-27T03:14:09Z"
  },
  "object": "list",
  "url": "/jurisdictions",
  "data": [
    {
      "code": "USA.S-CA",
      "name": "California",
      "type": "state",
      "is_collecting": true,
      "nexus": {
        "status": "CROSSED_THRESHOLD",
        "has_physical_nexus": false,
        "has_economic_nexus": true,
        "physical_nexus_type": "warehouse",
        "physical_nexus_date": "2025-08-01",
        "economic_sales_total": "51200000",
        "economic_taxable_sales": "49800000",
        "economic_transactions_count": 1820,
        "economic_threshold_percent": "49.87",
        "economic_threshold_date": "2026-03-11",
        "last_updated": "2026-06-01T09:12:00Z"
      },
      "registration": {
        "status": "COMPLETE",
        "origin": "NEW",
        "collection_start": "2026-04-01",
        "collection_end": null,
        "filing_cadences": [
          "QUARTERLY"
        ]
      }
    }
  ]
}

Lists the countries and US states your account touches, each with its nexus exposure and registration. A jurisdiction is listed once you have a registration there (requested, in progress or complete), tax collection set up there, or nexus activity there. A registration you have just requested shows up before you have any sales in that jurisdiction.

• The response is the whole list, sorted by code: no paging, and has_more is always false.
• A country’s code is its ISO 3166 alpha-3 code (ESP, SWE). A US state’s is USA.S- and its two-letter code (USA.S-CA).
• registration is null when you have no registration in that jurisdiction.
• Collection dates are in the jurisdiction’s local time.
• nexus_study tells you whether your economic nexus study has finished, so you don’t have to infer it from the rows.

​

Does Taxwire collect tax in a jurisdiction?

Find the item for that code and read is_collecting. If there is no item, or is_collecting is false, calculations return zero tax for that jurisdiction.

When is_collecting is true, Taxwire collects that country’s or state’s tax. A line can still come to zero tax, for example an exempt product or customer. Local taxes registered separately, such as Colorado home-rule cities, aren’t covered by the state’s item.

Don’t work it out from nexus.status, registration.status or the collection dates:

• A registration can be COMPLETE before collection starts.
• nexus.status says whether you owe tax there, not whether Taxwire collects it.
• Collection can stop and restart. collection_start is the earliest start, and collection_end stays null while a later period is still to come, so the dates alone can look like collection is on during a gap.

{
  "object": "list",
  "url": "/jurisdictions",
  "has_more": false,
  "nexus_study": { "status": "COMPLETE", "completed_at": "2026-09-27T03:14:09Z" },
  "data": [
    {
      "code": "ESP",
      "name": "Spain",
      "type": "country",
      "is_collecting": true,
      "nexus": { "status": "REMITTING", "has_economic_nexus": false, "has_physical_nexus": false },
      "registration": {
        "status": "COMPLETE",
        "origin": "NEW",
        "collection_start": "2026-11-01",
        "collection_end": null,
        "filing_cadences": ["QUARTERLY"]
      }
    },
    {
      "code": "SWE",
      "name": "Sweden",
      "type": "country",
      "is_collecting": false,
      "nexus": { "status": "NOT_EXPOSED", "has_economic_nexus": false, "has_physical_nexus": false },
      "registration": {
        "status": "SUBMITTED",
        "origin": "NEW",
        "collection_start": null,
        "collection_end": null,
        "filing_cadences": []
      }
    }
  ]
}

Here Taxwire collects tax in Spain. Sweden is listed because a registration was requested there, but calculations return zero tax there until collection starts.

Authorizations

APIKeyHeaderHTTPBearer

X-API-Key · string · header · required

Response

200

application/json

Successful Response

List envelope for GET /jurisdictions.

has_more · boolean · required

More results available

Examples:

true

false

nexus_study · NexusStudyBlock · object · required

Status of the economic nexus study for the account.

Show child attributes

object · string · default: list

url · string · default: /jurisdictions

data · Jurisdiction · object[]

One item per jurisdiction the account touches, sorted by code.

Show child attributes