Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.commenda.io/llms.txt

Use this file to discover all available pages before exploring further.

Commenda exposes several APIs that let you programmatically manage business entities, calculate indirect tax, incorporate companies, build workflows, and more. This page helps you find the right API for your use case and get started quickly.

Available APIs

Global Indirect Tax

Calculate tax rates, manage registrations, track transactions, handle exemptions, and automate filings across jurisdictions.

CommendaOS

Create and manage business entities, government identifiers, registrations, locations, credentials, and documents.

Company Name Checker

Check company name availability across US state jurisdictions before incorporation.

Compliance Calendar Preview

Generate a stateless preview of compliance obligations for a corporation profile and target fiscal year.

Incorporation

Create companies, start incorporation services, and track payment intents and document delivery through affiliate-scoped endpoints.

Workflow Builder

Define multi-step service request workflows with conditional logic, approvals, and automated task assignment.

Address API

Geocode and validate addresses for accurate tax jurisdiction resolution.

Which API do you need?

Use caseAPI
Calculate indirect tax on a transactionGlobal Indirect Tax
Create or retrieve business entitiesCommendaOS
Check company name availability before incorporationCompany Name Checker
Preview compliance obligations for a corporation profileCompliance Calendar Preview
Incorporate a new entity programmaticallyIncorporation
Manage tax registrations across jurisdictionsGlobal Indirect Tax — Registrations
Track registration thresholdsGlobal Indirect Tax — Registration Thresholds
Store and retrieve entity documentsCommendaOS — Documents
Automate multi-step service deliveryWorkflow Builder
Validate or geocode an addressAddress API

Authentication

Commenda APIs use two authentication methods depending on the API:

Legacy Affiliate API

The legacy affiliate API uses an affiliate API key passed in the x-api-key header:
curl --request GET \
  --url 'https://api.prod.commenda.io/api/v1/public/payment-intents' \
  --header 'x-api-key: <your_api_key>'

CommendaOS Partner API

The CommendaOS Partner API uses a partner API key passed in the x-api-key header:
curl --request GET \
  --url 'https://api.prod.commenda.io/api/v1/partner/commenda-os/customers/77/business-entities' \
  --header 'x-api-key: <partner_api_key>'

Managing partner API keys

Manage partner API keys in the Commenda dashboard under Settings > API keys. New keys are prefixed with cmda_ and are shown only once when they are created. Copy the key immediately and store it securely, because Commenda stores only a SHA-256 hash of the key and cannot show the raw value again later. To rotate a key, create a new key in the dashboard, update your integration to use it, confirm requests succeed, and then delete the old key.

Global Indirect Tax API

The Global Indirect Tax API uses Bearer token authentication. Include your token in the Authorization header of every request:
curl --request GET \
  --url 'https://transaction-tax.api.in.commenda.io/api/v1/registrations' \
  --header 'Authorization: Bearer <your_token>'
If Settings > API keys is not available in your dashboard, contact the Commenda team to enable API key management for your account.

Base URLs

APIBase URL
Global Indirect Taxhttps://transaction-tax.api.in.commenda.io/api/v1
Partner Incorporation APIhttps://api.prod.commenda.io/api/v1/partner/incorporation
CommendaOS Partner APIhttps://api.prod.commenda.io/api/v1/partner/commenda-os
Legacy Affiliate APIhttps://api.prod.commenda.io/api/v1/public
All endpoint paths in this documentation are relative to their respective base URL.

Next steps

Global Indirect Tax quickstart

Start calculating tax rates and managing transactions.

CommendaOS overview

Learn the entity data model before calling the API.