Documentation

Blog

Commenda API Docs

Sales Tax API Reference

Customs Duty API Reference

Dashboard

Support

Retrieve one transaction by its identifier

Get transaction

Either 5-digit ZIP code or 9-digit ZIP+4 code is accepted.

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

ISO 4217 alpha-3 currency code for the transaction.

2-letter code for each state. Suffix of the ISO 3166-2 code. Ex: CA, NY, TX.

The unique identifier for the corporation associated with this transaction.

Optional unique identifier for the customer. If provided, it may be used to retrieve defaults configured for the customers. Any explicitly provided customer details will take precedence over stored defaults.

Total discount amount applied to the subtotal.

Array of line items representing individual products or services in the transaction. For each line item either pass the tax_code or the product_id. If the product_id is passed the tax_code will be fetched from the product itself.

Total amount before tax, shipping, handling, and discounts.

ISO 8601 formatted date string indicating date on which the transaction took place. If tax calculations need to be based on a different date, please contact our team for assistance.

Numeric value representing the amount of tax paid by the customer for this transaction

This is the total amount charged to the customer, which includes the subtotal, shipping and handling fees, tax, and reflects any applied discounts.

Code passed by the caller to determine taxability for this product. Default value, TPP, will be taxable in every jurisdiction. Reach out to the Commenda team for alternative product codes.

The platform from which the transaction originated. This is useful for tracking transactions from different platforms.

Transactions are created in UNCOMMITTED state. In this state they can be updated or deleted. Transactions become locked and can't be edited once they've been reported on a filed return.

Type of the transaction. Currently sales and refund transactions are supported.

bearerAuth

Get one transaction

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

Get all corporations associated with a sales tax partner.

List corporations

Get corporation

Create a new corporation for a sales tax partner.

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

Submit a completed transaction for processing and filing

Create a transaction

List all transactions that match this query

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 status for one seller for all US states

Get nexus

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

Tax Registrations

Allows customers to inform the system about states where they are already registered for sales tax.

Create registration

Get registration

Fetches all sales tax registrations associated with a specific corporation.

List registrations

Allows customers to provide additional information about states where they are already registered for sales tax.

Update registration

Allows customers to remove a sales tax registration with `validation_status` in `PENDING`, `INVALID`, or `VALIDATION_IN_PROGRESS` states. Customers should reach out directly to Commenda for registrations in `VALID` state.

Delete registration

When all necessary details are provided and a seller is ready to start filing in a state, call this endpoint to request that the Commenda team onboard your sales tax registration for filing.

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 state and local sales tax filings for a corporation, filtered by query.

List filings

Get one filing

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 a customer to track their exemption certificates and default values for their addresses.

Create customer

List customers associated with a corporation.

List customers

Get detailed information about a specific customer, including exemption certificates.

Get customer

Update a customer, including their addresses and exemption certificates.

Update customer

Delete customer

Manage exemption certificates for a customer.

Exemption Certificates

Create an exemption certificate for a customer

Create exemption certificate

Get a specific exemption certificate by id.

Get exemption certificate

Get a list of all exemption certificates.

List exemption certificates

Delete an exemption certificate. This does not delete the associated file.

Delete exemption certificate

Files

Create files

List files

Retrieve one file by its id, along with a signed URL to download it

Get file

Delete file

Receive real-time notifications about system events.

Webhooks

Topics and Events

Create webhook

Get webhook

Get a list of all webhooks registered with Commenda.

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 transaction

Authorizations

Path Parameters

Response