get_taxes
Retrieve all available taxes with pagination and field filtering. Each tax includes key, name, amount, scope, and group for document integration.
Instructions
Get all available taxes with pagination support. Supports field filtering to reduce response size. Each tax has: key (the stable identifier, e.g. "s_iva_21"/"p_iva_21" — this is the value used in a document line's taxes[]), id (mirrors key), name, amount (the percentage as a string, e.g. "21"), scope ("sales" or "purchase"), group (e.g. "iva"), and type.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number (starting from 1, default: 1) | |
| fields | No | Select specific fields to return (e.g., ["key", "name", "amount", "scope"]). Reduces response size. If not provided, returns default fields: id, key, name, amount, scope, group, type. NOTE: the tax rate field is `amount` (not `percentage`) and the identifier is `key`. | |
| summary | No | Return only total count and page count without items (default: false) | |
| pageSize | No | Number of items per page (default: 50, max: 500) |