List lot runs
List runs newest-first. status accepts multiple comma-separated values (e.g. ?status=queued,generating for active runs). Other filters: product (GTIN), template (id), created_by (user id), and a created_after/created_before date range.
Authorizations
Query Parameters
Comma-separated LotRunStatus values to include.
Filter to a product's runs by GTIN.
Filter to a template's runs by id.
Filter to a creator's runs by user id.
Only runs created at/after this ISO-8601 timestamp.
Only runs created at/before this ISO-8601 timestamp.
Max results (1-200).
1 <= x <= 200Result offset for paging.
x >= 0Response
OK
Run id (22-char shortuuid). Use in /lots/runs/{id}/ paths.
Template this run generated against.
Template version pinned at generation time.
Counter scope key derived from the template's scope_kind.
GTIN of the product the generated lots belong to.
Number of identifiers requested.
Lifecycle state of the run.
queued, generating, reserved, committed, discarded, failed_collision Denormalized list of identifiers rendered by this run.
Random-source retries that resolved during generation.
Populated only on failed_collision runs; empty otherwise.
Creation timestamp (ISO-8601).
First identifier in the reserved block; null until reserved.
Last identifier in the reserved block; null until reserved.
Counter value (post-reset) before this run advanced it.
Counter value after this run; null on failed_collision.
Async progress: chunks written so far.
Async progress: total chunks the run will write.
User id that created the run; null if the user was deleted.
When the async run was enqueued.
When the worker began generating.
When the run was committed.
When the run was discarded.
When the run failed on a hard collision.
rollback or burn on a discarded run; null otherwise.
rollback, burn Free-text reason recorded when the run was discarded.