Documentation

Blog

Commenda API Docs

Sales Tax API Reference

Customs Duty API Reference

Dashboard

Support

Get one filing

ISO 3166 2-letter country code. Ex: US, IN, GB.

The legal name of the entity being registered.

2-letter code for each state. Suffix of the ISO 3166-2 code. Ex: CA, NY, TX. This can't be changed once set.

The unique identifier for a corporation associated with this filing.

ISO 8601 date string, identifying the date when by which the filing must be submitted.

Date when the taxes were filed with the state, in ISO 8601 format.

This object will be populated if the payment fails for any reason.

ISO 8601 date string, identifying the start date of the period period for which the sales tax is being filed (e.g., '2024-09-01' for September 2024). For a quarter 1 filing where the fiscal year starts in March, the period_start_date will be 2024-03-01 and frequency will be QUARTERLY.

The unique identifier for the tax registration associated with this filing.

Total sales tax collected during the period.

Total sales amount that was subject to sales tax for the filing period.

Total sales amount for the filing period.

Total amount of sales tax filed with various jurisdictions for this period. May differ slightly from the total tax collected.

Merchant's password for the state sales tax portal.

Once a merchant is registered in a state for sales tax, they need to pay the collected tax to the state government. This payment happens at a fixed interval. The interval is generally decided by the state government and differ from state to state as well as for each merchant.

Some sales tax state portal require a pin to access them. If the state requires it, this will need to be passed before validating this registration.

The unique identifier assigned to the merchant by the state government during registration.

Merchant's username for the state sales tax portal.

Some state like Texas provides a webfile number that is required by Commenda to perform accurate filings.

Filing frequency refers to how often a business is required to submit its sales tax returns, which is typically determined by the state based on the business's sales volume and tax liability.

bearerAuth

Welcome to Commenda's API Documentation! Learn how to use our API to manage your global tax workflows.

Introduction

Learn how to use the Commenda API to manage your taxes.

Sales Tax Transactions

Nexus

Exemptions

Understand how Commenda's Sales Tax API manages corporations for both single and multi-entity implementations.

Corporations

List corporations

Get corporation

Create corporation

Update corporation

Delete corporation

Calculates the tax amount for a given transaction.

Tax Calculations

Calculate tax

Record transactions after they occur to remit and file the correct amount.

Tax Transactions

Create a transaction

Get transaction

List transactions

Delete transaction

Mark a transaction as refunded to receive credit against a future tax liability.

Refund Transactions

Create a refund

Utility for sellers to bulk upload transactions.

Bulk Transactions

Upload bulk transactions

Get nexus

A system for sellers to manage their tax registrations, enabling accurate calculations and automated filing.

Tax Registrations

Create registration

Get registration

List registrations

Update registration

Delete registration

Request validation

Request new sales & use tax registrations for a seller in a particular state.

New Registrations

Get required information for new registrations

Submit required information for new registrations

List filings

Manage products and their tax codes for a corporation.

Products

Create product

Get product

List products

Update product

Delete product

Upload bulk products

Manage customers and their exemption certificates.

Customers

Create customer

List customers

Get customer

Update customer

Delete customer

Manage exemption certificates for a customer.

Exemption Certificates

Create exemption certificate

Get exemption certificate

List exemption certificates

Delete exemption certificate

Files

Create files

List files

Get file

Delete file

Receive real-time notifications about system events.

Webhooks

Topics and Events

Create webhook

Get webhook

List webhook

Update webhook

Delete webhook

Test webhook

Calculates the customs duty rate for a given shipment.

Sales Tax API

Core Concepts

Corporations

Calculate

Transactions

Nexus

Registrations

Filings

Products

Customers

Exemption Certificates

Files

Webhooks

Get one filing

Authorizations

Path Parameters

Response