---
title: "items__getItems"
method: POST
path: "/tools/items__getItems"
tags: ["Items"]
---

# items__getItems

`POST /tools/items__getItems`

Obtiene la lista de ítems registrados en la aplicación con filtros opcionales. Usar el parámetro "fields" para incluir datos adicionales cuando el contexto de la conversación lo requiera (e.g. inventory para consultas de stock, images para catálogos, editable/deletable para tareas de gestión).

## Request body

- object
  - `limit` integer — Cantidad máxima de ítems a retornar. Por defecto 30.
  - `start` integer — Offset para paginación (número de ítems a omitir).
  - `metadata` boolean — Si es true, la respuesta incluye { metadata: { total }, data: [...] } en lugar del array directo.
  - `query` string — Texto libre para buscar ítems por nombre o descripción.
  - `type` 'simple' | 'kit' | 'variantParent' | 'variant' | 'surtido' — Filtrar ítems por tipo.
  - `status` 'active' | 'inactive' — Filtrar ítems por estado.
  - `name` string — Filtrar ítems por nombre exacto.
  - `reference` string — Filtrar ítems por referencia o código SKU.
  - `idItemCategory` string — Filtrar ítems por ID de categoría de ítem.
  - `idWarehouse` string — Filtrar ítems por ID de bodega.
  - `order_field` string — Campo por el cual ordenar los resultados.
  - `order_direction` 'ASC' | 'DESC' — Dirección del ordenamiento.
  - `fields` string — Campos adicionales a retornar, separados por coma. Valores posibles: itemVariants, variantAttributes, subitems, editable, deletable, settingsOnShop, remissionedQuantity, negativeSale, source, simpleSale, inventory, images, attachments, productKey, tariffHeading, kitWarehouse, idGlobal.
  - `mode` 'advanced' | 'simple' — Modo de respuesta: simple retorna un conjunto reducido de campos.

## Response `200`

Lista de ítems registrados.

## Other responses

- `401` — No autorizado

---

[API](https://skmtc.net/alegra/apis/ingresos.md) · [All operations](https://skmtc.net/alegra/apis/ingresos/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/alegra/ingresos/versions/cd52d3f68f1b/schema)