Skip to main content
GET
/
admin
/
taxes
List Taxes
curl --request GET \
  --url https://api.decodahealth.com/admin/taxes \
  --header 'API-KEY: <api-key>' \
  --header 'TENANT: <tenant>'
[
  {
    "id": "<string>",
    "name": "<string>",
    "percentage": 123,
    "locationIds": [
      "<string>"
    ],
    "scope": "ALL",
    "categoryNames": [
      "<string>"
    ]
  }
]

Headers

​
TENANT
string
required

The tenant you are making this request on behalf of

​
API-KEY
string
required

Your api key

Response

200 - application/json

Successful Response

​
id
string
required

Unique identifier for the tax

​
name
string
required

Name of the tax (e.g., 'Sales Tax', 'VAT')

​
percentage
number
required

Tax percentage (e.g., 8.25 for 8.25%)

​
locationIds
string[] | null

Location IDs this tax applies to. Empty/null = all-locations (all locations)

​
scope
enum<string>
default:ALL

Scope of the tax (ALL, PRODUCTS_ONLY, SERVICES_ONLY, SPECIFIC_CATEGORIES)

Available options:
ALL,
PRODUCTS_ONLY,
SERVICES_ONLY,
MEMBERSHIPS_ONLY,
SPECIFIC_CATEGORIES
​
categoryNames
string[] | null

Category names for SPECIFIC_CATEGORIES scope