*MCP › Reference › Rentals › Subrents*

# Get a subrent

> Returns the detail of a subrent by its identifier.

Same record as the listing, without what is paid to the supplier.

TOOL `filmo_subrents_get` · `subrents:read` · 120/min · Server annotation: Read-only · Server annotation: Idempotent

## Arguments

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `subrentId` | string | Yes | Subrent identifier. |

## 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<date-time> | Start of the required period in ISO 8601 UTC; null if not set. |
| `endDate` | string<date-time> | End of the required period in ISO 8601 UTC; null if not set. |
| `pickupDate` | string<date-time> | Pickup date from the supplier in ISO 8601 UTC; null if not set. |
| `returnDate` | string<date-time> | 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<date-time> | Creation date in ISO 8601 UTC. |
| `updatedAt` | string<date-time> | Last modification date in ISO 8601 UTC. |

*Call · filmo_subrents_get*

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "filmo_subrents_get",
    "arguments": {
      "subrentId": "subr_8f2a1c"
    }
  }
}
```

*Result (generated from the schema)*

```json
{
  "structuredContent": {
    "data": {
      "id": "id_8f2a1c",
      "type": "bulk",
      "status": "pending",
      "itemId": "item_8f2a1c",
      "itemName": "Example",
      "itemSku": "<itemSku>",
      "quantity": 1,
      "serializedItemId": "seri_8f2a1c",
      "serializedItemCode": "<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": "<notes>",
      "createdAt": "2026-09-01T08:00:00Z",
      "updatedAt": "2026-09-01T08:00:00Z"
    },
    "meta": {
      "rateLimit": {
        "limit": 120,
        "remaining": 119,
        "reset": 42
      },
      "etag": "\"3sT3d9pBvZq4h2N0w8x1YkLmQ7c\""
    }
  }
}
```

## The same operation by REST

This tool runs [`GET /api/v1/subrents/{subrentId}`](https://docs.filmo.io/rest-api/endpoint-reference/subrents/get-a-subrent).

---

Canonical URL: https://docs.filmo.io/mcp/tools/subrents/filmo-subrents-get  
Last updated: 2026-10-25