Repair tickets

Get a repair ticket

Returns the detail of a repair ticket with its lines: which element is repaired, its diagnosis and its price for the customer.

Tool

filmo_repair_tickets_get

Readrepair-tickets:read

repair-tickets:read
120/min
May need an add-on
Server annotation: Read-only
Server annotation: Idempotent

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "filmo_repair_tickets_get",
    "arguments": {
      "ticketId": "tick_8f2a1c"
    }
  }
}

{
  "structuredContent": {
    "data": {
      "id": "id_8f2a1c",
      "number": "<number>",
      "date": "2026-09-01T08:00:00Z",
      "status": "draft",
      "orderId": "orde_8f2a1c",
      "orderNumber": "<orderNumber>",
      "contactId": "cont_8f2a1c",
      "contactName": "Example",
      "subTotal": "1234.50",
      "taxTotal": "1234.50",
      "total": "1234.50",
      "totalLines": 1,
      "notes": "<notes>",
      "createdAt": "2026-09-01T08:00:00Z",
      "updatedAt": "2026-09-01T08:00:00Z",
      "projectId": "proj_8f2a1c",
      "lines": [
        {
          "id": "id_8f2a1c",
          "entityType": "item",
          "entityId": "enti_8f2a1c",
          "entityName": "Example",
          "description": "<description>",
          "diagnosis": "<diagnosis>",
          "quantity": 1,
          "unitPrice": "1234.50",
          "incidentId": "inci_8f2a1c",
          "notes": "<notes>"
        }
      ],
      "sourceIncidentIds": [
        "sour_8f2a1c"
      ],
      "customFields": {
        "key": "<key>"
      }
    },
    "meta": {
      "rateLimit": {
        "limit": 120,
        "remaining": 119,
        "reset": 42
      },
      "etag": "\"3sT3d9pBvZq4h2N0w8x1YkLmQ7c\""
    }
  }
}

generated from the schema

Arguments

ticketIdstringRequired

Repair ticket identifier.

Limits: min length 1

Result

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

Show the attributes of data

idstring

Unique ticket identifier.

numberstring

Ticket number, for example "RT-2026-0001".

datestring<date-time>

Issue date in ISO 8601 UTC.

statusstring

Status of the ticket in its lifecycle.

Available options: draft, sent, partially_converted, fully_invoiced, closed

orderIdstring | null

Identifier of the order it comes from; null if it was created standalone.

orderNumberstring | null

Number of the order it comes from; null if it was created standalone.

contactIdstring | null

Identifier of the responsible client; null if none has been assigned.

contactNamestring | null

Name of the responsible client; null if not resolved.

subTotalstring

Sum of the lines before taxes, as a decimal string "1234.50".

Limits: pattern ^-?\d+\.\d{2}$

taxTotalstring

Tax total, as a decimal string "1234.50".

Limits: pattern ^-?\d+\.\d{2}$

totalstring

Total including taxes, as a decimal string "1234.50".

Limits: pattern ^-?\d+\.\d{2}$

totalLinesinteger

Number of lines in the ticket.

notesstring | null

General remarks; null if it has none.

createdAtstring<date-time>

Creation date in ISO 8601 UTC.

updatedAtstring<date-time>

Last modification date in ISO 8601 UTC.

projectIdstring | null

Identifier of the associated project; null if it has none.

linesobject[]

Ticket lines.

Show child attributes

lines.idstring

Unique line identifier.

lines.entityTypestring | null

Type of element being repaired: item, serializedItem (a specific unit), space or kit; null for a free line (a service, a charge).

Available options: item, serializedItem, space, kit

lines.entityIdstring | null

Identifier of the element being repaired; null if it is a free line.

lines.entityNamestring | null

Name of the element being repaired; null if not resolved.

lines.descriptionstring

What needs to be repaired.

lines.diagnosisstring | null

Technical diagnosis; null if none has been recorded.

lines.quantitynumber | null

Affected units; null if not applicable.

lines.unitPricestring | null

NET unit price quoted to the client, as a decimal string "1234.50". It is not the repair cost: that one is not published. null if the line has no price.

Limits: pattern ^-?\d+\.\d{2}$

lines.incidentIdstring | null

Identifier of the incident that originated this line; null if it does not come from one.

lines.notesstring | null

Line notes; null if it has none.

sourceIncidentIdsstring[]

Identifiers of the incidents that originated the ticket.

customFieldsobject<string, any>

Custom field values by custom field identifier; the definitions are in /api/v1/custom-fields.

An error is a result with isError: true and the problem in content[0].text; there is no structuredContent. See Errors.

The same operation by REST

This tool runs GET /api/v1/repair-tickets/{ticketId}.

Repair tickets
Get a repair ticket
Returns the detail of a repair ticket with its lines: which element is repaired, its diagnosis and its price for the customer.
Guides
Safe writes
An assistant that can write can also write the wrong thing. Decide which tools need a person, retry without duplicating, and know what a write sets in motion.
Guides
Errors
A tool error is a result with isError: true and the problem in the first text block. Branch on its code.

Was this page helpful?

Result

Arguments

Result

The same operation by REST

Related pages

Get a repair ticket

Safe writes

Errors