Registrations
Create registration
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
Registrations
Create registration
Allows customers to inform the system about states where they are already registered for sales tax.
POST
/
registrations
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
application/json
Response
200
application/json
Sales tax registration response
The response is of type object
.
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."
}