Skip to main content
POST
/
v1
/
tax
/
estimate
curl --request POST \
  --url https://api.cadanapay.com/v1/tax/estimate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "countryCode": "QA",
  "type": "gross-to-net",
  "salary": {
    "amount": 1000000,
    "currency": "QAR"
  }
}
'
{
  "grossAmount": {
    "amount": 1000000,
    "currency": "QAR"
  },
  "netAmount": {
    "amount": 930000,
    "currency": "QAR"
  },
  "deductions": [
    {
      "name": "Social Insurance",
      "isStatutory": true,
      "amount": {
        "amount": 70000,
        "currency": "QAR"
      }
    }
  ],
  "employerContributions": [
    {
      "name": "Social Insurance",
      "isStatutory": true,
      "amount": {
        "amount": 140000,
        "currency": "QAR"
      }
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.cadanapay.com/llms.txt

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

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

X-MultiTenantKey
string

Required when using a Platform API token. The tenant key identifying which business to operate on.

Body

application/json
countryCode
string
required

Country code for tax estimation

type
enum<string>
required

Type of estimation

Available options:
gross-to-net,
net-to-gross
salary
object
required
regionCode
string

Optional region/state code

outputCurrency
string

ISO 4217 currency to convert response amounts into. When different from the salary currency, all amounts are converted at the prevailing FX rate and fxRate is populated on the response.

Example:

"USD"

Response

Estimate taxes response

grossAmount
object
required
netAmount
object
required
deductions
object[]
required
employerContributions
object[]
required
allowances
object[]

Imputed-income line items (e.g. benefits-in-kind) surfaced by the country engine. Omitted when none apply.

outputCurrency
string

Echo of the requested outputCurrency. Present only when the request specified a conversion.

Example:

"USD"

fxRate
string

FX rate applied to convert from the input currency to outputCurrency. Present only when a conversion was performed.

Example:

"0.058"