*MCP › Reference › Operations › Repair tickets* # List repair tickets > Returns the repair tickets of the account, cursor-paginated: what broke, on which order it came back broken and what the customer is quoted to fix it. Amounts are sale amounts to the customer; the repair cost is not published. TOOL `filmo_repair_tickets_list` · `repair-tickets:read` · 120/min · May need an add-on · 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. | | `q` | string | No | Free-text search on the ticket number and the notes. | | `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, date, status, total. 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 ticket status: draft, sent, partially_converted, fully_invoiced or closed. `draft`, `sent`, `partially_converted`, `fully_invoiced`, `closed` | | `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. `draft`, `sent`, `partially_converted`, `fully_invoiced`, `closed` | | `orderId` | string | No | Filter by identifier of the order the ticket comes from. | | `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. | | `contactId` | string | No | Filter by identifier of the client responsible for the repair. | | `contactIds` | string[] | No | Filter by contactId, 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, 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.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 ticket identifier. | | `number` | string | Ticket number, for example "RT-2026-0001". | | `date` | string | Issue date in ISO 8601 UTC. | | `status` | string | Status of the ticket in its lifecycle. `draft`, `sent`, `partially_converted`, `fully_invoiced`, `closed` | | `orderId` | string | Identifier of the order it comes from; null if it was created standalone. | | `orderNumber` | string | Number of the order it comes from; null if it was created standalone. | | `contactId` | string | Identifier of the responsible client; null if none has been assigned. | | `contactName` | string | Name of the responsible client; null if not resolved. | | `subTotal` | string | Sum of the lines before taxes, as a decimal string "1234.50". | | `taxTotal` | string | Tax total, as a decimal string "1234.50". | | `total` | string | Total including taxes, as a decimal string "1234.50". | | `totalLines` | integer | Number of lines in the ticket. | | `notes` | string | General remarks; null if it has none. | | `createdAt` | string | Creation date in ISO 8601 UTC. | | `updatedAt` | string | Last modification date in ISO 8601 UTC. | *Call · filmo_repair_tickets_list* ```json { "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "filmo_repair_tickets_list", "arguments": { "limit": 20 } } } ``` *Result (generated from the schema)* ```json { "structuredContent": { "data": [ { "id": "id_8f2a1c", "number": "", "date": "2026-09-01T08:00:00Z", "status": "draft", "orderId": "orde_8f2a1c", "orderNumber": "", "contactId": "cont_8f2a1c", "contactName": "Example", "subTotal": "1234.50", "taxTotal": "1234.50", "total": "1234.50", "totalLines": 1, "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/repair-tickets`](https://docs.filmo.io/rest-api/endpoint-reference/repair-tickets/list-repair-tickets). --- Canonical URL: https://docs.filmo.io/mcp/tools/repair-tickets/filmo-repair-tickets-list Last updated: 2026-10-25