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
Filings
List filings
List state and local sales tax filings for a corporation, filtered by query.
GET
/
filings
curl --request GET \
--url https://base_url/api/v1/filings \
--header 'Authorization: Bearer <token>'
{
"data": {
"filings": [
{
"id": "<string>",
"corporation_id": "<string>",
"country": "US",
"country_specific_details": {
"legal_name": "Example Inc.",
"state": "CA",
"state_specific_details": {
"payment_interval": "<string>",
"sales_tax_id": "<string>",
"username": "<string>",
"password": "<string>",
"pin": "<string>",
"web_file_number": "<string>",
"tax_types": [
"RSST"
]
}
},
"frequency": "MONTHLY",
"period_start_date": "2023-12-25",
"due_date": "2023-12-25",
"filing_status": "PENDING",
"filed_on": "2023-12-25",
"registration_id": "<string>",
"total_tax_filed": 135.92,
"payment_details": {
"amount_due": 123,
"payment_status": "PENDING",
"failure_details": {
"failed_at": "2023-12-25",
"reason": "<string>"
}
}
}
],
"cursor": "<string>"
},
"message": "Successfully fetched filings."
}
Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Query Parameters
The unique identifier of the corporation for which to retrieve data.
Cursor for pagination
Number of items to return per page
Required range:
1 <= x <= 100
Response
200
application/json
Filing info for all states
The response is of type object
.
curl --request GET \
--url https://base_url/api/v1/filings \
--header 'Authorization: Bearer <token>'
{
"data": {
"filings": [
{
"id": "<string>",
"corporation_id": "<string>",
"country": "US",
"country_specific_details": {
"legal_name": "Example Inc.",
"state": "CA",
"state_specific_details": {
"payment_interval": "<string>",
"sales_tax_id": "<string>",
"username": "<string>",
"password": "<string>",
"pin": "<string>",
"web_file_number": "<string>",
"tax_types": [
"RSST"
]
}
},
"frequency": "MONTHLY",
"period_start_date": "2023-12-25",
"due_date": "2023-12-25",
"filing_status": "PENDING",
"filed_on": "2023-12-25",
"registration_id": "<string>",
"total_tax_filed": 135.92,
"payment_details": {
"amount_due": 123,
"payment_status": "PENDING",
"failure_details": {
"failed_at": "2023-12-25",
"reason": "<string>"
}
}
}
],
"cursor": "<string>"
},
"message": "Successfully fetched filings."
}