Jurisdictions

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 --request GET \
  --url https://api.taxwire.com/jurisdictions \
  --header 'X-API-Key: <api-key>'

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.taxwire.com/jurisdictions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.taxwire.com/jurisdictions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.taxwire.com/jurisdictions"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.taxwire.com/jurisdictions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "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"
        ]
      }
    }
  ]
}

{
  "errors": [
    {
      "status": "422",
      "code": "validation_required_field",
      "title": "Missing quantity",
      "detail": "Please provide a value for the required quantity field",
      "source": {
        "pointer": "/data/attributes/line_items/0/quantity"
      }
    }
  ]
}

{
  "errors": [
    {
      "status": "429",
      "code": "rate_limit_error",
      "title": "Too Many Requests",
      "detail": "Rate limit exceeded"
    }
  ]
}

{
  "errors": [
    {
      "status": "500",
      "code": "system_internal_error",
      "title": "Internal Error",
      "detail": "An unexpected error occurred. Our team has been notified."
    }
  ]
}

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

X-API-Key

string

header

required

Response

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

List Jurisdictions

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

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.taxwire.com/jurisdictions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.taxwire.com/jurisdictions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.taxwire.com/jurisdictions"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.taxwire.com/jurisdictions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "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"
        ]
      }
    }
  ]
}

{
  "errors": [
    {
      "status": "422",
      "code": "validation_required_field",
      "title": "Missing quantity",
      "detail": "Please provide a value for the required quantity field",
      "source": {
        "pointer": "/data/attributes/line_items/0/quantity"
      }
    }
  ]
}

{
  "errors": [
    {
      "status": "429",
      "code": "rate_limit_error",
      "title": "Too Many Requests",
      "detail": "Rate limit exceeded"
    }
  ]
}

{
  "errors": [
    {
      "status": "500",
      "code": "system_internal_error",
      "title": "Internal Error",
      "detail": "An unexpected error occurred. Our team has been notified."
    }
  ]
}

Getting Started

Guides

Transaction flows

API details

Calculations

Transactions

Customers

Certificates

Jurisdictions

Product Tax Codes (PTC) & Attributes

Products

Resources

List jurisdictions

Does Taxwire collect tax in a jurisdiction?

Authorizations

Response

​Does Taxwire collect tax in a jurisdiction?

Authorizations

Response

Does Taxwire collect tax in a jurisdiction?