---
title: "Listar impuestos"
method: POST
path: "/tools/taxes_getTaxes"
tags: ["Taxes"]
---

# Listar impuestos

`POST /tools/taxes_getTaxes`

## Request

- Base URL: `https://mcp.alegra.com`
- URL: `https://mcp.alegra.com/tools/taxes_getTaxes`
- Auth: HTTP bearer

Herramienta MCP: `taxes_getTaxes`.

Devuelve los impuestos configurados en la empresa, paginados y con filtros opcionales de búsqueda, estado, ordenamiento y selección de campos.

Ejemplo de llamada JSON-RPC:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "taxes_getTaxes",
    "arguments": { "start": 0, "limit": 30 }
  }
}
```

Paginación con `start` (desplazamiento desde 0) y `limit` (cantidad de impuestos a devolver). Filtra por nombre con `name`, por texto general con `query` y por estado con `includeInactive` en `true` para incluir también los impuestos inactivos.

Ordena con `order_field` (campo por el cual ordenar; valores pendientes de verificar con una llamada real) y `order_direction` (`asc` o `desc`, en minúsculas). Con `fields` solicitas campos adicionales separados por coma, con `metadata` incluyes metadatos en la respuesta y con `globalFilter` más `globalFilterFields` haces una búsqueda global sobre los campos indicados.

Úsala para descubrir los `id` de los impuestos que necesitan las herramientas de facturación, ítems u otras consultas.

Solo lectura.

## Request body

- object
  - `start` integer: Desplazamiento de paginación (desde 0).
  - `limit` integer: Cantidad de impuestos a devolver.
  - `order_direction` 'asc' | 'desc': Dirección de ordenamiento: asc o desc (en minúsculas).
  - `order_field` string: Campo por el cual ordenar. Valores pendientes de verificar con una llamada real.
  - `query` string: Texto general de búsqueda.
  - `name` string: Filtra por nombre del impuesto.
  - `metadata` boolean: Si es true, incluye metadatos en la respuesta.
  - `includeInactive` boolean: Si es true, incluye también los impuestos inactivos.
  - `fields` string: Campos adicionales a retornar, separados por coma (por ejemplo editable,deletable).
  - `globalFilterFields` string: Campos sobre los que se aplica la búsqueda global, separados por coma.
  - `globalFilter` string: Texto de búsqueda para el filtro global. Se usa junto con globalFilterFields.

## Response `200`

Lista de impuestos

## Other responses

- `401`: No autorizado (token de Alegra inválido o expirado).

---

[API](https://skmtc.dev/alegra/apis/mcp-alegra.md) - [All operations](https://skmtc.dev/alegra/apis/mcp-alegra/llms.txt) - [OpenAPI document](https://skmtc.dev/alegra/apis/mcp-alegra/revisions/528447af020b?raw)