*MCP › Reference › Rentals › Subrents* # List subrents > Returns the material rented from other companies to cover a job: what was brought in, from whom and for which order. It answers "of this order, what is mine and what did I have to bring in". It does not emit what is paid to the supplier. TOOL `filmo_subrents_list` · `subrents:read` · 120/min · Server annotation: Read-only · Server annotation: Idempotent ## Arguments | Name | Type | Required | Description | | --- | --- | --- | --- | | `limit` | integer | No | Page size (1-500). Defaults to 50. = `50` | | `cursor` | string | No | Opaque cursor of the page to return. Pass the value of `pagination.nextCursor` from the previous response; treat it as opaque. | | `sort` | string | No | Sort order: up to 3 comma-separated fields, each with a leading "-" for descending (e.g. "-updatedAt,name"). Sortable fields: createdAt, updatedAt, startDate, endDate, pickupDate, returnDate, status, type, quantity. Defaults to "-createdAt". Ties are broken by id, so the order is stable across pages, and a cursor is bound to the sort it was issued with. | | `status` | string | No | Filter by subrent status. `pending`, `active`, `completed`, `cancelled` | | `statuses` | string[] | No | Filter by status, as a list: repeat the parameter or separate the values with commas. Accepts up to 50 values and returns whatever matches any of them. `pending`, `active`, `completed`, `cancelled` | | `type` | string | No | Filter by type: bulk (quantity of a bulk item) or serialized (a specific unit). `bulk`, `serialized` | | `types` | string[] | No | Filter by type, as a list: repeat the parameter or separate the values with commas. Accepts up to 50 values and returns whatever matches any of them. `bulk`, `serialized` | | `orderId` | string | No | Filter by the order that motivates it. | | `orderIds` | string[] | No | Filter by orderId, as a list: repeat the parameter or separate the values with commas. Accepts up to 50 values and returns whatever matches any of them. | | `projectId` | string | No | Filter by associated project. | | `projectIds` | string[] | No | Filter by projectId, as a list: repeat the parameter or separate the values with commas. Accepts up to 50 values and returns whatever matches any of them. | | `itemId` | string | No | Filter by subrented item. | | `itemIds` | string[] | No | Filter by itemId, as a list: repeat the parameter or separate the values with commas. Accepts up to 50 values and returns whatever matches any of them. | | `includeTotal` | boolean | No | Set it to true to include `pagination.total`, the number of results that match the filters across all pages. Off by default. = `false` | | `dateFilters` | object | No | Date filters by field. A bare day (YYYY-MM-DD) is read in the business timezone; an ISO 8601 instant with offset is applied as is by gte, lte, gt and lt, while on widens it to the whole business day that contains it. Fields: created, return, updated. | | `dateFilters.created` | object | No | | | `dateFilters.created.gte` | string | No | From this day or instant, inclusive. | | `dateFilters.created.lte` | string | No | Up to this day or instant, inclusive. | | `dateFilters.created.gt` | string | No | Strictly after; a bare day means after the end of that day. | | `dateFilters.created.lt` | string | No | Strictly before; a bare day means before the start of that day. | | `dateFilters.created.on` | string | No | Exactly that day; an instant means the whole business day that contains it. | | `dateFilters.return` | object | No | | | `dateFilters.return.gte` | string | No | From this day or instant, inclusive. | | `dateFilters.return.lte` | string | No | Up to this day or instant, inclusive. | | `dateFilters.return.gt` | string | No | Strictly after; a bare day means after the end of that day. | | `dateFilters.return.lt` | string | No | Strictly before; a bare day means before the start of that day. | | `dateFilters.return.on` | string | No | Exactly that day; an instant means the whole business day that contains it. | | `dateFilters.updated` | object | No | | | `dateFilters.updated.gte` | string | No | From this day or instant, inclusive. | | `dateFilters.updated.lte` | string | No | Up to this day or instant, inclusive. | | `dateFilters.updated.gt` | string | No | Strictly after; a bare day means after the end of that day. | | `dateFilters.updated.lt` | string | No | Strictly before; a bare day means before the start of that day. | | `dateFilters.updated.on` | string | No | Exactly that day; an instant means the whole business day that contains it. | ## Result On success the result carries `structuredContent` with `data` and `meta`. These are the attributes of `data`. | Name | Type | Description | | --- | --- | --- | | `id` | string | Unique subrent identifier. | | `type` | string | bulk if it is a quantity of a bulk item, serialized if it is a specific unit. `bulk`, `serialized` | | `status` | string | Subrent status. `pending`, `active`, `completed`, `cancelled` | | `itemId` | string | Identifier of the subrented item. | | `itemName` | string | Name of the subrented item. | | `itemSku` | string | Item SKU; null if it has none. | | `quantity` | number | Subrented units; null if it is a specific unit. | | `serializedItemId` | string | Identifier of the specific unit; null if bulk. | | `serializedItemCode` | string | Code of the specific unit; null if bulk. | | `providerId` | string | Identifier of the supplier that lends the material; null if not decided yet. | | `providerName` | string | Supplier name; null if not decided yet. | | `needResolved` | boolean | true if the need is already covered, that is, if the supplier and material are confirmed. | | `startDate` | string | Start of the required period in ISO 8601 UTC; null if not set. | | `endDate` | string | End of the required period in ISO 8601 UTC; null if not set. | | `pickupDate` | string | Pickup date from the supplier in ISO 8601 UTC; null if not set. | | `returnDate` | string | Return date to the supplier in ISO 8601 UTC; null if not set. | | `orderId` | string | Order that motivates the subrent; null if it has none. | | `projectId` | string | Associated project; null if it has none. | | `purchaseOrderId` | string | Purchase order that formalizes it; null if none has been issued. | | `spaceId` | string | Warehouse where the material is received; null if not applicable. | | `notes` | string | Subrent notes; null if it has none. | | `createdAt` | string | Creation date in ISO 8601 UTC. | | `updatedAt` | string | Last modification date in ISO 8601 UTC. | *Call · filmo_subrents_list* ```json { "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "filmo_subrents_list", "arguments": { "limit": 20 } } } ``` *Result (generated from the schema)* ```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 } } } } ``` ## The same operation by REST This tool runs [`GET /api/v1/subrents`](https://docs.filmo.io/rest-api/endpoint-reference/subrents/list-subrents). --- Canonical URL: https://docs.filmo.io/mcp/tools/subrents/filmo-subrents-list Last updated: 2026-10-25