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
Create registration
Allows customers to inform the system about states where they are already registered for sales tax.
curl --request POST \
--url https://base_url/api/v1/registrations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"corporation_id": "2535af08-a139-4d0c-9827-1651e46dfbcf",
"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"
]
}
},
"registered_at": "2023-12-25",
"country_options": {
"US": {
"legal_name": "<string>",
"state": "<string>",
"state_options": {
"payment_interval": "<string>",
"sales_tax_id": "<string>",
"username": "<string>",
"password": "<string>",
"pin": "<string>",
"web_file_number": "<string>",
"tax_types": [
"RSST"
]
}
}
}
}'{
"data": {
"registration_id": "ec6d3db8-fd31-4303-8687-3ff98fb10ebf",
"corporation_id": "2535af08-a139-4d0c-9827-1651e46dfbcf",
"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"
]
}
},
"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",
"jurisdiction": "CA"
},
"message": "Successfully created registration."
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
The unique identifier for a corporation.
"2535af08-a139-4d0c-9827-1651e46dfbcf"
ISO 3166 2-letter country code. Ex: US, IN, GB.
"US"
ISO 8601 date only string, identifying the date when the state registration occurred.
Legal name of the entity.
State code.
Payment interval for sales tax.
Sales tax ID.
Username for tax filing.
Password for tax filing.
PIN for tax filing.
Web file number for tax filing.
Enum representing different types of taxes applicable in various jurisdictions.
RSST, RST, RUT, SSUT, GRT, VUT, RTPT, TPT, DTT, RDF, SUT, GET, ROT, CUT, RSSUT, BAO The legal name of the entity being registered.
"Example Inc."
2-letter code for each state. Suffix of the ISO 3166-2 code. Ex: CA, NY, TX.
"CA"
Payment interval for sales tax.
Sales tax ID.
Username for tax filing.
Password for tax filing.
PIN for tax filing.
Web file number for tax filing.
Enum representing different types of taxes applicable in various jurisdictions.
RSST, RST, RUT, SSUT, GRT, VUT, RTPT, TPT, DTT, RDF, SUT, GET, ROT, CUT, RSSUT, BAO Response
The unique identifier for the registration.
"ec6d3db8-fd31-4303-8687-3ff98fb10ebf"
The unique identifier for a corporation.
"2535af08-a139-4d0c-9827-1651e46dfbcf"
ISO 3166 2-letter country code. Ex: US, IN, GB.
"US"
The legal name of the entity being registered.
"Example Inc."
2-letter code for each state. Suffix of the ISO 3166-2 code. Ex: CA, NY, TX.
"CA"
Payment interval for sales tax.
Sales tax ID.
Username for tax filing.
Password for tax filing.
PIN for tax filing.
Web file number for tax filing.
Enum representing different types of taxes applicable in various jurisdictions.
RSST, RST, RUT, SSUT, GRT, VUT, RTPT, TPT, DTT, RDF, SUT, GET, ROT, CUT, RSSUT, BAO 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 two letter identifier of the jurisdiction this registration applies to.
"CA"
Indicates whether Commenda is automatically filing taxes for this tax registration.
FILING, NOT_FILING "Successfully created registration."
curl --request POST \
--url https://base_url/api/v1/registrations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"corporation_id": "2535af08-a139-4d0c-9827-1651e46dfbcf",
"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"
]
}
},
"registered_at": "2023-12-25",
"country_options": {
"US": {
"legal_name": "<string>",
"state": "<string>",
"state_options": {
"payment_interval": "<string>",
"sales_tax_id": "<string>",
"username": "<string>",
"password": "<string>",
"pin": "<string>",
"web_file_number": "<string>",
"tax_types": [
"RSST"
]
}
}
}
}'{
"data": {
"registration_id": "ec6d3db8-fd31-4303-8687-3ff98fb10ebf",
"corporation_id": "2535af08-a139-4d0c-9827-1651e46dfbcf",
"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"
]
}
},
"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",
"jurisdiction": "CA"
},
"message": "Successfully created registration."
}