Getting Started with Cadana Global Tax API

Pre-Requisites and Usage

An active business on Cadana and an org API key is required to use the Tax API.
Please go through the guides on API keys and authentication before you continue.

Integration Steps

Step 1: Check Location Support

First, verify tax calculation support for your desired location. This API also returns the list of valid states for a given country that would be required subsequently when registering a payee.

List Locations

Step 2: Get Required Tax Information

Retrieve the required additional tax fields for the location to accurately calculate taxes.

List Tax Fields

Step 3: Register a Tax Payee

Create a payee record with their tax profile. The Payee ID is needed for every tax calculation.

Step 4: Calculate Taxes

Calculate taxes for your registered payee.

Calculate Taxes

Alternative: Register and Calculate in One Step

You can also create a new payee and calculate taxes in a single request by providing the required details directly to the calculate taxes endpoint:

{
  "salary": {
    "amount": 10000.00,
    "currency": "MXN"
  },
	"address": {
    "line1": "Av. Reforma 123",
    "line2": "Apt 4",
    "city": "Mexico City",
    "postalCode": "01000",
    "state": "DUR",
    "countryCode": "MX"
  },
  "additionalAttributes": {
    "employerSize": "small",
    "riskCategory" : "II"
  }
}

Next Steps

Explore our detailed API Reference for complete endpoint documentation