Tax

List tax rate definitions

Return all active tax rate definitions for the merchant (used for manual tax mode).

GET
/tax/rate-definitions

Authorization

bearerAuth
AuthorizationBearer <token>

Use your secret API key as the bearer token

In: header

Response Body

application/json

application/json

curl -X GET "https://api.getlumen.dev/v1/tax/rate-definitions"
[
  {
    "id": "tax_rate_def_1Abc9rQp3Kf4s6T8uYz0Lp",
    "merchantId": "mer_4aExPpQ7R3tSa1BcDe9LmN",
    "name": "Germany VAT 19%",
    "description": "Standard VAT rate",
    "taxRate": "0.19",
    "jurisdiction": "DE",
    "taxType": "manual",
    "isActive": true,
    "createdAt": "2025-02-01T10:00:00.000Z",
    "updatedAt": "2025-02-01T10:00:00.000Z"
  }
]
{
  "error": "Internal server error"
}