Retrieve a serial
Authorizations
API key issued per entity via Settings > Developers > API Keys.
Each key carries scopes (e.g. orders:read, products:write).
Bearer token format: Authorization: Bearer ark_live_ent_Test keys use ark_test_ent_. Both are issued per entity
via Settings > Developers > API Keys.
Path Parameters
Response
Serial
A serial-tracked unit of a product. Created in bulk by generateSerials at purchase-order receipt (status available) and walks the lifecycle available -> allocated -> sold -> returned -> dispositioned. The disposition action records a terminal outcome (restock, write_off, return_to_vendor) and the link-lot action attaches the serial to a lot for traceability. Scope: serials:read / serials:write / serials:delete. Rule 23 SSOT: status is written only by canonical generateSerials / allocateSerial / consumeSerial / receiveSerialReturn / dispositionSerial.
"serial"
Unique-per-product serial value. 1..255 chars.
Lifecycle state. See enum serial_status.
available, allocated, sold, returned, dispositioned "available"
Layer 4 location scope; serials are warehouse-bound.
Current allocation/sale order, if any.
Current outbound package, if any.
Linked lot for traceability; null if not lot-tracked.
Convenience copy of lots.lot_code at link time; lot_id is the FK.
active, expired, voided.
Previous allocation; preserved through return cycles.

