*MCP › Reference › Rentals › Orders*

# List the lines of an order

> Returns which resources the order carries (items, spaces, services and custom elements) with their quantities, their specific serialized units, their period and their sale price.

It is the usual query after getting an order. Lines added during delivery are left out unless requested with `includeDelivery=true`. It emits no cost or margin data. Lines belong to the order and are only obtained through it: there is no independent collection of lines. Lines come in document order.

TOOL `filmo_orders_lines_list` · `orders:read` · 120/min · Server annotation: Read-only · Server annotation: Idempotent

## Arguments

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `orderId` | string | Yes | Order identifier. |
| `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: position, itemName, quantity, startDate, endDate, rentalDays, unitPrice, linePrice, status, resourceType, transactionType. Defaults to "position". Ties are broken by id, so the order is stable across pages, and a cursor is bound to the sort it was issued with. |
| `resourceType` | string | No | Filter by line resource type: item, space, service, custom, section or type_group. `item`, `kit`, `space`, `vehicle`, `personnel`, `service`, `custom`, `section`, `type_group` |
| `transactionType` | string | No | Filter by line nature: rental or sale. `rental`, `sale` |
| `includeDelivery` | boolean | No | If "true", also includes the lines added during the delivery process. By default only the lines of the original order are returned. = `false` |
| `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` |

## Result

On success the result carries `structuredContent` with `data` and `meta`. These are the attributes of `data`.

| Name | Type | Description |
| --- | --- | --- |
| `id` | string | Unique line identifier. |
| `orderId` | string | Identifier of the order the line belongs to. |
| `resourceType` | string | Resource type of the line. Lines of type section and type_group are presentation groupings with no associated resource. `item`, `kit`, `space`, `vehicle`, `personnel`, `service`, `custom`, `section`, `type_group` |
| `transactionType` | string | Nature of the line: rental or sale. `rental`, `sale` |
| `status` | string | Status of the line within the order flow. `draft`, `reserved`, `prepared`, `picked_up`, `sold`, `returned`, `checked_in`, `cancelled`, `lost` |
| `position` | integer | Display position of the line within the order, starting at 0. |
| `addedDuringDelivery` | boolean | true if the line was added during the delivery process rather than in the original order. |
| `itemId` | string | Catalog item identifier; null if the line is not of type item. |
| `itemName` | string | Name of the item, space, service or custom element of the line. |
| `variantId` | string | Identifier of the item variant; null if not applicable. |
| `spaceId` | string | Space identifier; null if the line is not of type space. |
| `quantity` | number | Units of the line. |
| `serials` | object[] | Specific physical units assigned. Empty for non-serialized items or when not yet assigned. |
| `serials.id` | string | Unique identifier of the serialized item. |
| `serials.code` | string | Internal code of the unit; null if none. |
| `serials.serialNumber` | string | Manufacturer serial number; null if not recorded. |
| `startDate` | string<date-time> | Start of the line period in ISO 8601 UTC; null if it inherits the order period. |
| `endDate` | string<date-time> | End of the line period in ISO 8601 UTC; null if it inherits the order period. |
| `rentalDays` | number | Billable rental days of the line; null if not calculated. |
| `unitPrice` | string | Net unit price as a decimal string "1234.50"; null if the line has no price of its own. |
| `linePrice` | string | Total net amount of the line as a decimal string "1234.50"; null if not calculated. |
| `free` | boolean | true if the line is explicitly billed at zero. |
| `notes` | string | Line notes; null if none. |

*Call · filmo_orders_lines_list*

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "filmo_orders_lines_list",
    "arguments": {
      "orderId": "orde_8f2a1c",
      "limit": 20
    }
  }
}
```

*Result (generated from the schema)*

```json
{
  "structuredContent": {
    "data": [
      {
        "id": "id_8f2a1c",
        "orderId": "orde_8f2a1c",
        "resourceType": "item",
        "transactionType": "rental",
        "status": "draft",
        "position": 1,
        "addedDuringDelivery": true,
        "itemId": "item_8f2a1c",
        "itemName": "Example",
        "variantId": "vari_8f2a1c",
        "spaceId": "spac_8f2a1c",
        "quantity": 1,
        "serials": [
          {
            "id": "id_8f2a1c",
            "code": "<code>",
            "serialNumber": "<serialNumber>"
          }
        ],
        "startDate": "2026-09-01T08:00:00Z",
        "endDate": "2026-09-01T08:00:00Z",
        "rentalDays": 1,
        "unitPrice": "1234.50",
        "linePrice": "1234.50",
        "free": true,
        "notes": "<notes>"
      }
    ],
    "pagination": {
      "nextCursor": "eyJvIjo1MH0",
      "hasMore": true,
      "total": 1
    },
    "meta": {
      "rateLimit": {
        "limit": 120,
        "remaining": 119,
        "reset": 42
      },
      "etag": "\"3sT3d9pBvZq4h2N0w8x1YkLmQ7c\""
    }
  }
}
```

## The same operation by REST

This tool runs [`GET /api/v1/orders/{orderId}/lines`](https://docs.filmo.io/rest-api/endpoint-reference/orders/list-the-lines-of-an-order).

---

Canonical URL: https://docs.filmo.io/mcp/tools/orders/filmo-orders-lines-list  
Last updated: 2026-10-25