Sales Tax API
Core Concepts
Corporations
Calculate
Transactions
- Tax Transactions
- POSTCreate a transaction
- GETGet transaction
- GETList transactions
- DELDelete transaction
- Refund Transactions
- Bulk Transaction Import
Nexus
Registrations
Products
Customers
Exemption Certificates
Get nexus
Get nexus status for one seller for all US states
curl --request GET \
--url https://base_url/api/v1/nexus \
--header 'Authorization: Bearer <token>'{
"data": {
"corporation_id": "b6d009b0-d174-463f-b030-94643c28e209",
"states": [
{
"state": "CA",
"nexus_rule": {
"sales_threshold": 100000,
"transaction_threshold": 200,
"threshold_type": "SALES_OR_TRANSACTIONS",
"evaluation_period_type": "PREV_CALENDAR_YEAR"
},
"calculation": {
"sales_exposure_percentage": 0.06,
"transaction_exposure_percentage": 0.1235,
"total_sales": 12345.9,
"total_transactions": 12
},
"is_nexus_breached": true,
"date_of_breach": "<string>"
}
]
},
"message": "Successfully fetched nexus."
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
The unique identifier for a corporation. All transactions associated with the specified corporation will be returned.
Response
An object with a 'state' property containing an array of nexus objects for all states.
The unique identifier for a corporation associated with this nexus details.
"b6d009b0-d174-463f-b030-94643c28e209"
2-letter code for each state. Suffix of the ISO 3166-2 code. Ex: CA, NY, TX.
"CA"
The percentage of the state's sales threshold that the business has reached during the current evaluation period for this state. This metric indicates how close a business is to reaching or exceeding the sales threshold for economic nexus in a given state.
0 <= x <= 10.06
The percentage of the state's transaction threshold that the business has reached during the current evaluation period for this state. This metric shows how close a business is to reaching or exceeding the transaction threshold for economic nexus in a given state.
0 <= x <= 10.1235
Total sales made by the customer in a state during the current evaluation period for this state.
12345.9
Total number of transactions reported by the entity in a state during the current evaluation period for this state.
12
Indicates if your business has previously established nexus (tax presence) in this state.
ISO 8601 date only string, identifying the date when your business first established nexus in this state.
The maximum amount of gross sales revenue a business can generate within a state before triggering an obligation to collect and remit sales tax.
100000
The maximum number of separate sales transactions a business can conduct within a state before triggering an obligation to collect and remit sales tax.
200
Specifies how a state calculates its economic nexus threshold. This determines which criteria a state uses to establish whether a business has reached nexus and is required to collect and remit sales tax. Some states consider only sales revenue, some only the number of transactions, and others consider both factors.
SALES_ONLY, SALES_OR_TRANSACTIONS, SALES_AND_TRANSACTIONS "SALES_OR_TRANSACTIONS"
The time frame over which a state evaluates economic nexus. Transactions within this period are counted towards the nexus threshold.
PREV_CALENDAR_YEAR, PREV_OR_CURRENT_CALENDAR_YEAR, PRECEDING_12_MONTHS, PRECEDING_FISCAL_YEAR, PRECEDING_12_MONTHS_ENDING_SEPT_30 "Successfully fetched nexus."
curl --request GET \
--url https://base_url/api/v1/nexus \
--header 'Authorization: Bearer <token>'{
"data": {
"corporation_id": "b6d009b0-d174-463f-b030-94643c28e209",
"states": [
{
"state": "CA",
"nexus_rule": {
"sales_threshold": 100000,
"transaction_threshold": 200,
"threshold_type": "SALES_OR_TRANSACTIONS",
"evaluation_period_type": "PREV_CALENDAR_YEAR"
},
"calculation": {
"sales_exposure_percentage": 0.06,
"transaction_exposure_percentage": 0.1235,
"total_sales": 12345.9,
"total_transactions": 12
},
"is_nexus_breached": true,
"date_of_breach": "<string>"
}
]
},
"message": "Successfully fetched nexus."
}