*MCP › Referencia › Alquileres › Subalquileres* # Listar subalquileres > Devuelve el material alquilado a otras empresas para cubrir un trabajo: qué se trajo, de quién y para qué pedido. Responde a «de este pedido, qué es mío y qué tuve que traer de fuera». No emite lo que se paga al proveedor. HERRAMIENTA `filmo_subrents_list` · `subrents:read` · 120/min · Anotación del servidor: Solo lectura · Anotación del servidor: Idempotente ## Argumentos | Nombre | Tipo | Obligatorio | Descripción | | --- | --- | --- | --- | | `limit` | integer | No | Tamaño de página (1-500). Por defecto es 50. = `50` | | `cursor` | string | No | Cursor opaco de la página que se devuelve. Pasa el valor de `pagination.nextCursor` de la respuesta anterior; trátalo como opaco. | | `sort` | string | No | Orden: hasta 3 campos separados por comas, cada uno con un "-" inicial para descendente (p. ej. "-updatedAt,name"). Campos ordenables: createdAt, updatedAt, startDate, endDate, pickupDate, returnDate, status, type, quantity. Por defecto, "-createdAt". Los empates se resuelven por id, así que el orden es estable entre páginas, y un cursor queda ligado al orden con el que se emitió. | | `status` | string | No | Filtra por estado del subalquiler. `pending`, `active`, `completed`, `cancelled` | | `statuses` | string[] | No | Filtra por status, como lista: repite el parámetro o separa los valores con comas. Acepta hasta 50 valores y devuelve lo que coincida con cualquiera de ellos. `pending`, `active`, `completed`, `cancelled` | | `type` | string | No | Filtra por tipo: bulk (cantidad de un artículo a granel) o serialized (una unidad concreta). `bulk`, `serialized` | | `types` | string[] | No | Filtra por type, como lista: repite el parámetro o separa los valores con comas. Acepta hasta 50 valores y devuelve lo que coincida con cualquiera de ellos. `bulk`, `serialized` | | `orderId` | string | No | Filtra por el pedido que lo motiva. | | `orderIds` | string[] | No | Filtra por orderId, como lista: repite el parámetro o separa los valores con comas. Acepta hasta 50 valores y devuelve lo que coincida con cualquiera de ellos. | | `projectId` | string | No | Filtra por proyecto asociado. | | `projectIds` | string[] | No | Filtra por projectId, como lista: repite el parámetro o separa los valores con comas. Acepta hasta 50 valores y devuelve lo que coincida con cualquiera de ellos. | | `itemId` | string | No | Filtra por artículo subalquilado. | | `itemIds` | string[] | No | Filtra por itemId, como lista: repite el parámetro o separa los valores con comas. Acepta hasta 50 valores y devuelve lo que coincida con cualquiera de ellos. | | `includeTotal` | boolean | No | Ponlo en true para incluir `pagination.total`, el número de resultados que coinciden con los filtros en todas las páginas. Desactivado por defecto. = `false` | | `dateFilters` | object | No | Filtros de fecha por campo. Una fecha sin hora (YYYY-MM-DD) se lee en la zona horaria del negocio; un instante ISO 8601 con desplazamiento se aplica tal cual con gte, lte, gt y lt, mientras que on lo amplía al día completo del negocio que lo contiene. Campos: created, return, updated. | | `dateFilters.created` | object | No | | | `dateFilters.created.gte` | string | No | Desde este día o instante, inclusive. | | `dateFilters.created.lte` | string | No | Hasta este día o instante, inclusive. | | `dateFilters.created.gt` | string | No | Estrictamente posterior; una fecha sin hora significa después del final de ese día. | | `dateFilters.created.lt` | string | No | Estrictamente anterior; una fecha sin hora significa antes del inicio de ese día. | | `dateFilters.created.on` | string | No | Exactamente ese día; un instante significa toda la jornada del negocio que lo contiene. | | `dateFilters.return` | object | No | | | `dateFilters.return.gte` | string | No | Desde este día o instante, inclusive. | | `dateFilters.return.lte` | string | No | Hasta este día o instante, inclusive. | | `dateFilters.return.gt` | string | No | Estrictamente posterior; una fecha sin hora significa después del final de ese día. | | `dateFilters.return.lt` | string | No | Estrictamente anterior; una fecha sin hora significa antes del inicio de ese día. | | `dateFilters.return.on` | string | No | Exactamente ese día; un instante significa toda la jornada del negocio que lo contiene. | | `dateFilters.updated` | object | No | | | `dateFilters.updated.gte` | string | No | Desde este día o instante, inclusive. | | `dateFilters.updated.lte` | string | No | Hasta este día o instante, inclusive. | | `dateFilters.updated.gt` | string | No | Estrictamente posterior; una fecha sin hora significa después del final de ese día. | | `dateFilters.updated.lt` | string | No | Estrictamente anterior; una fecha sin hora significa antes del inicio de ese día. | | `dateFilters.updated.on` | string | No | Exactamente ese día; un instante significa toda la jornada del negocio que lo contiene. | ## Resultado En un éxito el resultado lleva `structuredContent` con `data` y `meta`. Estos son los atributos de `data`. | Nombre | Tipo | Descripción | | --- | --- | --- | | `id` | string | Identificador único del subalquiler. | | `type` | string | bulk si es una cantidad de un artículo a granel, serialized si es una unidad concreta. `bulk`, `serialized` | | `status` | string | Estado del subalquiler. `pending`, `active`, `completed`, `cancelled` | | `itemId` | string | Identificador del artículo subalquilado. | | `itemName` | string | Nombre del artículo subalquilado. | | `itemSku` | string | SKU del artículo; null si no tiene. | | `quantity` | number | Unidades subalquiladas; null si es una unidad concreta. | | `serializedItemId` | string | Identificador de la unidad concreta; null si es a granel. | | `serializedItemCode` | string | Código de la unidad concreta; null si es a granel. | | `providerId` | string | Identificador del proveedor que cede el material; null si aún no está decidido. | | `providerName` | string | Nombre del proveedor; null si aún no está decidido. | | `needResolved` | boolean | true si la necesidad ya está cubierta, es decir, si el proveedor y el material están confirmados. | | `startDate` | string | Inicio del periodo requerido en ISO 8601 UTC; null si no está definido. | | `endDate` | string | Fin del periodo requerido en ISO 8601 UTC; null si no está definido. | | `pickupDate` | string | Fecha de recogida en el proveedor en ISO 8601 UTC; null si no se ha fijado. | | `returnDate` | string | Fecha de devolución al proveedor en ISO 8601 UTC; null si no está definida. | | `orderId` | string | Pedido que motiva el subalquiler; null si no tiene. | | `projectId` | string | Proyecto asociado; null si no tiene. | | `purchaseOrderId` | string | Pedido de compra que lo formaliza; null si no se ha emitido ninguno. | | `spaceId` | string | Almacén donde se recibe el material; null si no aplica. | | `notes` | string | Notas del subalquiler; null si no tiene. | | `createdAt` | string | Fecha de creación en ISO 8601 UTC. | | `updatedAt` | string | Fecha de la última modificación en ISO 8601 UTC. | *Llamada · filmo_subrents_list* ```json { "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "filmo_subrents_list", "arguments": { "limit": 20 } } } ``` *Resultado (generado desde el esquema)* ```json { "structuredContent": { "data": [ { "id": "id_8f2a1c", "type": "bulk", "status": "pending", "itemId": "item_8f2a1c", "itemName": "Example", "itemSku": "", "quantity": 1, "serializedItemId": "seri_8f2a1c", "serializedItemCode": "", "providerId": "prov_8f2a1c", "providerName": "Example", "needResolved": true, "startDate": "2026-09-01T08:00:00Z", "endDate": "2026-09-01T08:00:00Z", "pickupDate": "2026-09-01T08:00:00Z", "returnDate": "2026-09-01T08:00:00Z", "orderId": "orde_8f2a1c", "projectId": "proj_8f2a1c", "purchaseOrderId": "purc_8f2a1c", "spaceId": "spac_8f2a1c", "notes": "", "createdAt": "2026-09-01T08:00:00Z", "updatedAt": "2026-09-01T08:00:00Z" } ], "pagination": { "nextCursor": "eyJvIjo1MH0", "hasMore": true, "total": 1 }, "meta": { "rateLimit": { "limit": 120, "remaining": 119, "reset": 42 } } } } ``` ## La misma operación por REST Esta herramienta ejecuta [`GET /api/v1/subrents`](https://docs.filmo.io/es/rest-api/endpoint-reference/subrents/list-subrents). --- URL canónica: https://docs.filmo.io/es/mcp/tools/subrents/filmo-subrents-list Última actualización: 2026-10-25