Get all taxes with filters

Retrieves a list of taxes with optional filtering and pagination.

Use Cases

• List all available tax rates
• Search taxes by name
• Filter active/inactive taxes
• Export tax configuration

Query Parameters

• skip: Number of records to skip (default: 0, min: 0)
• take: Number of records to return (default: 10, min: 1, max: 100)
• name: Filter taxes by name (partial match, case-insensitive)
• active: Filter by active status (true/false)

Example Request

GET /api/v0/taxes?skip=0&take=20&active=true&name=Sales

Example Response

[
  {
    "id": "tax_123456",
    "name": "Sales Tax",
    "description": "Standard sales tax for retail transactions",
    "percentage": 8.5,
    "active": true,
    "created_at": "2024-03-20T10:00:00Z",
    "updated_at": "2024-03-20T10:00:00Z"
  }
]

GET /api/v0/taxes

Get all taxes with filters

cURL

curl --request GET \
  --url https://api.devdraft.ai/api/v0/taxes \
  --header 'x-client-secret: <api-key>'

Authorizations

x-client-secretx-client-key

x-client-secret · string · header · required

Your secret API key. Keep this secure and never expose it in client-side code.

Query Parameters

skip · number · default: 0

Number of records to skip for pagination

Required range: x >= 0

Example:

0

take · number · default: 10

Number of records to return (max 100)

Required range: 1 <= x <= 100

Example:

10

name · string

Filter taxes by name (partial match, case-insensitive)

Maximum string length: 100

Example:

"Sales"

active · boolean

Filter by active status

Example:

true

Response

200

Successfully retrieved taxes