Skip to main content
GET
Get a lot

Authorizations

X-API-Key
string
header
required

Path Parameters

gtin
string
required

GTIN barcode (8, 12, 13 or 14 digits), normalized to GTIN-14 for lookup.

Pattern: ^[0-9]{8,14}$
lot_id
string<shortuuid>
required

Id of the lot.

Required string length: 22
Pattern: ^[23456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$

Response

OK

A lot as read from the API. Mirrors ProductLot.

id
string<shortuuid>
required

URL-safe 22-character shortuuid encoding of the row's UUID primary key. Stable across the row's lifetime; suitable for sharing in URLs, log lines, and external SDK clients. Accepted on input as either the shortuuid form or the canonical UUID form (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx).

Required string length: 22
Pattern: ^[23456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$
product_id
string<shortuuid>
required

The product this lot belongs to.

Required string length: 22
Pattern: ^[23456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$
gtin
string
required

The product's GTIN, normalized to GTIN-14.

lot_identifier
string
required

GS1 AI(10) batch or lot number.

created
string<date-time>
required

Server-side ISO 8601 timestamp of creation (UTC).

modified
string<date-time>
required

Server-side ISO 8601 timestamp of last modification (UTC).

production_date
string<date-time> | null

When the lot was produced. Null when unset.

expiration_date
string<date> | null

Expiration date (GS1 AI 17). Null when unset.

best_before_date
string<date> | null

Best-before date (GS1 AI 15). Null when unset.

quantity
number | null

Total quantity in the lot. Null when unset.

unit_of_measure
enum<string> | null

Unit of the lot's quantity. Null when unset.

Available options:
EA,
DZN,
CS,
PLT,
GRM,
KGM,
LBR,
OZA,
MLT,
LTR,
GLL,
FOZ