---
title: "Listar transferencias entre bodegas"
method: POST
path: "/tools/warehousesTransfers_getWarehouseTransfers"
tags: ["Items"]
---

# Listar transferencias entre bodegas

`POST /tools/warehousesTransfers_getWarehouseTransfers`

## Request

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

Herramienta MCP: `warehousesTransfers_getWarehouseTransfers`.

Devuelve la lista de transferencias entre bodegas, con filtros opcionales y paginación.

Ejemplo de llamada JSON-RPC:

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

Úsala para listar transferencias, filtrar por fecha, ítem o número de transferencia, o verificar con `fields` (`editable`, `deletable`) el estado de gestión de una transferencia. Si ya conoces el ID, prefiere `warehousesTransfers_getWarehouseTransfer`: es más rápida y devuelve datos más completos.

`id` filtra por el número secuencial de la transferencia (el campo numérico, no el UUID). `item_id` filtra por el ID numérico del ítem incluido en la transferencia y `date` filtra por una fecha concreta en formato `YYYY-MM-DD`.

Paginación con `start` (desplazamiento desde 0) y `limit` (cantidad de registros por página; no la superes por encima de 30, que es el máximo permitido). Con `metadata: true` la respuesta se envuelve como `{ data: [...], metadata: { total } }`.

Solo lectura.

## Request body

- object
  - `limit` integer: Cantidad de registros por página. 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 se envuelve como { data: [...], metadata: { total } }.
  - `id` string: Filtra por el número secuencial de la transferencia (el campo numérico, no el UUID). Por ejemplo `"5"`.
  - `item_id` number: Filtra las transferencias que incluyen un ítem específico, por su ID numérico.
  - `date` string: Filtra por una fecha concreta en formato `YYYY-MM-DD`.
  - `fields` string: Campos extra a incluir. Valores válidos: `editable`, `deletable`.

## Response `200`

Lista de transferencias entre bodegas

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