Scope: accounting:taxes.read https://api.alladdin.com/api/v2/taxes

Returns the complete list of taxes configured in your account. Taxes define the VAT, GST, or other rates applied to document line items.
Use this endpoint to discover available tax IDs before creating documents. Each tax includes its percentage rate, type, and applicable region.

Request

import requests

url = "https://api.alladdin.com/api/v2/taxes"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json",
}

response = requests.get(url, headers=headers)
print(response.json())

Responses

Response

{
  "items": [
    {
      "id": "string",
      "name": "string",
      "amount": "string",
      "scope": "string",
      "key": "string",
      "group": "string",
      "type": "string",
      "items": [
        "string"
      ],
      "status": false,
      "visible": false
    }
  ]
}

Success responses

200 List of taxes application/json object items[] object[] id string

Tax unique identifier. Use this value in the taxes array when creating products or document line items.

name string

Tax name

amount string | null

Tax percentage as string for precision

scope string | null

Tax scope

key string

Tax key identifier

group string

Tax group

type string

Tax type

items[] string[]

Tax sub-item keys

status boolean

Whether the tax is active

visible boolean

Whether the tax is visible

Error responses

401 Invalid or missing API key application/json 403 Insufficient permissions application/json 429 Rate limit exceeded application/json

Next →Get sorted tax keys by country and section →