Thresholds

Get economic nexus thresholds for a jurisdiction.

Endpoint

GET /v1/thresholds

Parameters

Parameter	Type	Required	Description
`jurisdiction`	string	Yes	ISO code
`type`	string	No	Threshold type filter

Example

curl "https://api.shipvat.com/v1/thresholds?jurisdiction=US-CA" \
  -H "Authorization: Bearer sk_your_api_key"

Response

{
  "jurisdiction": "US-CA",
  "jurisdiction_name": "California",
  "thresholds": [{
    "type": "REMOTE_SELLER_NEXUS",
    "amount_minor": 50000000,
    "currency": "USD",
    "transaction_count": null,
    "condition": "AMOUNT_ONLY",
    "period": "previous_calendar_year",
    "provenance": {
      "source_name": "CA CDTFA",
      "status": "VERIFIED"
    }
  }],
  "queried_at": "2024-01-15T10:30:00Z"
}

amount_minor is either null or a non-negative safe integer in the minor unit of the adjacent ISO currency.

Threshold Types

VAT_REGISTRATION - EU/UK VAT registration
REMOTE_SELLER_NEXUS - US economic nexus
PST_REMOTE_SELLER - Canadian PST nexus
GST_SMALL_SUPPLIER - GST small supplier exemption