List Taxes

Retrieve a list of all tax configurations in your account.

Endpoint

GET /api/taxes

Query Parameters

ParameterTypeRequiredDescription
pageintegerNoPage number (default: 1)
limitintegerNoNumber of items per page (default: 20)
typestringNoFilter by tax type
countrystringNoFilter by country

Response

Returns a list of tax objects.
{
  "data": [
    {
      "id": "tax_123456789",
      "name": "VAT 20%",
      "rate": 20.0,
      "type": "VAT",
      "country": "GB",
      "region": null,
      "created_at": "2023-01-01T00:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 1
  }
}