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
List registrations
Fetches all sales tax registrations associated with a specific corporation.
curl --request GET \
--url https://base_url/api/v1/registrations \
--header 'Authorization: Bearer <token>'{
"data": {
"registrations": [
{
"id": "ec6d3db8-fd31-4303-8687-3ff98fb10ebf",
"corporation_id": "<string>",
"country": "US",
"country_options": {
"US": {
"state": "CA",
"legal_name": "Example Inc.",
"state_options": {
"CA": {
"payment_interval": "ANNUAL_CALENDAR_YEAR",
"sales_tax_id": "<string>",
"username": "<string>",
"password": "<string>",
"pin": "<string>",
"web_file_number": "<string>"
}
}
}
},
"registered_at": "2023-12-25",
"validation_status": "PENDING",
"filing_status": "FILING",
"registration_status": "REGISTRATION_IN_PROGRESS",
"business_activity_status": "VALID",
"registration_type": "SALES_TAX_REGISTRATION"
}
]
},
"message": "Successfully fetched registrations."
}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.
Response
The unique identifier of the corporation associated with this registration.
ISO 3166 2-letter country code. Ex: US, IN, GB.
"US"
2-letter code for each state. Suffix of the ISO 3166-2 code. Ex: CA, NY, TX. This can't be changed once set.
"CA"
The legal name of the entity being registered.
"Example Inc."
ISO 8601 date only string, identifying the date when the state registration occurred.
Reflects whether Commenda has validated the seller's registration details.
PENDING, VALIDATION_IN_PROGRESS, INVALID, VALID Reflects the current stage of the registration process.
REGISTRATION_IN_PROGRESS, REGISTERED Reflects whether the registration is active and the business is operating in a given State.
VALID, INVALID, PENDING, VALIDATION_IN_PROGRESS Type of registration. Request additional types from the Commenda team as required.
SALES_TAX_REGISTRATION The unique identifier for the registration.
"ec6d3db8-fd31-4303-8687-3ff98fb10ebf"
Indicates whether Commenda is automatically filing taxes for this tax registration.
FILING, NOT_FILING "Successfully fetched registrations."
curl --request GET \
--url https://base_url/api/v1/registrations \
--header 'Authorization: Bearer <token>'{
"data": {
"registrations": [
{
"id": "ec6d3db8-fd31-4303-8687-3ff98fb10ebf",
"corporation_id": "<string>",
"country": "US",
"country_options": {
"US": {
"state": "CA",
"legal_name": "Example Inc.",
"state_options": {
"CA": {
"payment_interval": "ANNUAL_CALENDAR_YEAR",
"sales_tax_id": "<string>",
"username": "<string>",
"password": "<string>",
"pin": "<string>",
"web_file_number": "<string>"
}
}
}
},
"registered_at": "2023-12-25",
"validation_status": "PENDING",
"filing_status": "FILING",
"registration_status": "REGISTRATION_IN_PROGRESS",
"business_activity_status": "VALID",
"registration_type": "SALES_TAX_REGISTRATION"
}
]
},
"message": "Successfully fetched registrations."
}