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
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.
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 < 1
Total sales made by the customer in a state during the current evaluation period for this state.
Total number of transactions reported by the entity in a state during the current evaluation period for this state.
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 < 1
ISO 8601 date only string, identifying the date when your business first established nexus in this state.
Indicates if your business has previously established nexus (tax presence) in this state.
2-letter code for each state. Suffix of the ISO 3166-2 code. Ex: CA, NY, TX.
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
The maximum amount of gross sales revenue a business can generate within a state before triggering an obligation to collect and remit sales tax.
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
The maximum number of separate sales transactions a business can conduct within a state before triggering an obligation to collect and remit sales tax.