Read a lot run
Return a single run by id, including its status, generated ids, counter state, and any collisions.
Authorizations
Path Parameters
Run id (UUID or 22-char shortuuid).
Response
OK
A generation run and its outcome.
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.