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 Person

Create a person record with their tax profile. The Person ID is needed for every tax calculation.

Step 4: Calculate Taxes

Calculate taxes for your registered payee.

Calculate Taxes

Override Tax Attributes

You can override any of the stored payee tax attributes during calculation:

{
  "personId": "123e4567-e89b-12d3-a456-426614174000",
  "salary": {
    "amount": 10000.00,
    "currency": "BRL"
  },
  "additionalAttributes": {
    "numberOfDependents": 3  // Override stored value
  }
}

Next Steps

Explore our detailed API Reference for complete endpoint documentation