Items

Get a serialized item

Returns the record of a specific physical unit: its code, its serial number, its status and the catalog item it is a unit of.

Tool

filmo_serialized_items_get

Readitems:read

items:read
120/min
Server annotation: Read-only
Server annotation: Idempotent

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "filmo_serialized_items_get",
    "arguments": {
      "serializedItemId": "seri_8f2a1c"
    }
  }
}

{
  "structuredContent": {
    "data": {
      "id": "id_8f2a1c",
      "code": "<code>",
      "serialNumber": "<serialNumber>",
      "status": "<status>",
      "itemId": "item_8f2a1c",
      "itemName": "Example",
      "itemSku": "<itemSku>",
      "itemCollectionName": "Example",
      "createdAt": "2026-09-01T08:00:00Z",
      "updatedAt": "2026-09-01T08:00:00Z"
    },
    "meta": {
      "rateLimit": {
        "limit": 120,
        "remaining": 119,
        "reset": 42
      },
      "etag": "\"3sT3d9pBvZq4h2N0w8x1YkLmQ7c\""
    }
  }
}

generated from the schema

It is narrower than the listing on purpose. The line history and the incidents of the unit are not emitted here.

Arguments

serializedItemIdstringRequired

Serialized item 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 identifier of the physical unit.

codestring

Internal code of the unit.

serialNumberstring | null

Manufacturer serial number; null if not registered.

statusstring

Current status of the unit within the inventory cycle.

itemIdstring

Identifier of the catalog item this unit belongs to.

itemNamestring

Name of the catalog item.

itemSkustring | null

SKU of the item; null if it has none.

itemCollectionNamestring | null

Name of the collection of the item; null if it is in none.

createdAtstring<date-time> | null

Creation date in ISO 8601 UTC; null if not recorded.

updatedAtstring<date-time> | null

Last modification date in ISO 8601 UTC; null if not recorded.

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/serialized-items/{serializedItemId}.

Items
Get a serialized item
Returns the record of a specific physical unit: its code, its serial number, its status and the catalog item it is a unit of.
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 serialized item

Safe writes

Errors