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.

GET
/api/v1/serialized-items/{serializedItemId}

Request examples

curl https://app.filmo.io/api/v1/serialized-items/seri_8f2a1c \
  --header "Authorization: Bearer $FILMO_API_KEY"
{
  "data": {
    "id": "serialized_item_9f3a2b",
    "code": "Example code",
    "serialNumber": "2026-0001",
    "status": "Example status",
    "itemId": "item_9f3a2b",
    "itemName": "Example item name",
    "itemSku": "Example item sku",
    "itemCollectionName": "Example item collection name",
    "createdAt": "2026-09-01T08:00:00.000Z",
    "updatedAt": "2026-09-01T08:00:00.000Z"
  }
}

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.

Authorizations

Bearer API key with the scope below. items:read

Headers

If-None-Matchstring

Conditional read: the ETag of the copy you already have. If the resource has not changed, the response is 304 with no body.

Example:"\"3sT3d9pBvZq4h2N0w8x1YkLmQ7c\""

Path parameters

serializedItemIdstringRequired

Serialized item identifier.

Limits: min length 1

Response

application/json

Successful response.

Response schema: SerializedItemDetailDto

Envelope: SerializedItemDetailResponse. meta.warnings is present only when the operation is deprecated.

Headers: X-Request-Id · RateLimit-Limit · RateLimit-Remaining · RateLimit-Reset · ETag

dataobject

The serialized item in full, as returned by the API.

Show child attributes
data.idstring

Unique identifier of the physical unit.

data.codestring

Internal code of the unit.

data.serialNumberstring | null

Manufacturer serial number; null if not registered.

data.statusstring

Current status of the unit within the inventory cycle.

data.itemIdstring

Identifier of the catalog item this unit belongs to.

data.itemNamestring

Name of the catalog item.

data.itemSkustring | null

SKU of the item; null if it has none.

data.itemCollectionNamestring | null

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

data.createdAtstring<date-time> | null

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

data.updatedAtstring<date-time> | null

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

metaobject

Additional information about the response.

Show child attributes
meta.warningsobject[]

Lifecycle warnings; present only when the operation is deprecated.

Show child attributes
meta.warnings.codestring

Stable warning code.

Available options: deprecated

meta.warnings.messagestring

For people: what is deprecated, until when, and what to use.

meta.warnings.sunsetstring

Day (YYYY-MM-DD) the operation stops being served.

meta.warnings.replacementstring | null

operationId of the operation to use instead, or null if there is none.

Errors

StatusCodesMeaning
404not_foundIt does not exist or is outside the scope of the API key.

401, 403, 429, 500 can be returned by any operation. Errors

Deprecation

This operation is not deprecated. Deprecations are announced with a Deprecation header and a sunset date. Versioning policy

  • Catalog & inventory

    Serialized item

    Specific physical unit of an item, with its serial number and where it is.