---
title: "Listar categorías de ítems"
method: POST
path: "/tools/itemCategories_getItemCategories"
tags: ["Items"]
---

# Listar categorías de ítems

`POST /tools/itemCategories_getItemCategories`

## Request

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

Herramienta MCP: `itemCategories_getItemCategories`.

Devuelve la lista de categorías de productos y servicios, con filtros opcionales y paginación.

Ejemplo de llamada JSON-RPC:

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

Úsala para descubrir las categorías disponibles o buscar una por nombre cuando no conoces su ID. Si ya conoces el ID, prefiere `itemCategories_getItemCategory`: es más rápida y devuelve datos más completos.

`fields` admite valores separados por comas: `editable`, `deletable` y `status`. `order_field` (por ejemplo `name`) y `order_direction` solo se envían cuando el usuario pide explícitamente un orden.

Paginación con `start` (desplazamiento desde 0) y `limit` (cantidad de resultados por página; no la superes por encima de 30, que es el máximo permitido). Con `metadata: true` la respuesta incluye el total de categorías.

Solo lectura.

## Request body

- object
  - `limit` integer: Cantidad máxima de categorías a devolver. No la superes por encima de 30: es el máximo permitido.
  - `start` integer: Desplazamiento de paginación (desde 0).
  - `metadata` boolean: Si es true, la respuesta incluye metadatos con el total de categorías.
  - `name` string: Filtra las categorías por nombre.
  - `fields` string: Campos extra separados por comas (por ejemplo `editable,deletable,status`).
  - `order_direction` 'ASC' | 'DESC': Dirección del orden.
  - `order_field` string: Campo por el que ordenar (por ejemplo `name`).

## Response `200`

Lista de categorías de ítems

## 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)