Skip to main content
GET
List the lots of a product

Authorizations

Authorization
string
header
required

Token returned by POST /auth/token, sent as Authorization: Bearer <token>.

Query Parameters

sku
string

Exact SKU of the product. Required unless bar_code is sent. Must not be blank.

bar_code
string

Exact barcode (UPC/EAN) of the product. Required unless sku is sent. Must not be blank.

lot_code
string

Exact lot code to return (no substring matching).

status

Lot status to include. Send a single value or repeat as status[] for several.

Available options:
ACTIVE,
HOLDED,
DAMAGED,
EXPIRED
expiration_from
string<date>

Only lots expiring on or after this date (YYYY-MM-DD, inclusive).

expiration_to
string<date>

Only lots expiring on or before this date (YYYY-MM-DD, inclusive).

page
integer
default:1

Page number, starting at 1.

Required range: x >= 1
per_page
integer
default:25

Lots per page, between 1 and 200.

Required range: 1 <= x <= 200

Response

The product and one page of its lots.

Response of GET /lots.

product
object
required

The product whose lots are listed.

lots
object[]
required

One page of the product's lots, soonest expiration first.

meta
object
required

Paging information returned next to list results.