GET /releases/{releaseId}/delivery-status

Get a release's delivery status

Retrieve the release's overall delivery state and its current state at each outlet. The overall state is one of not_submitted, in_progress, live, removing, removed, or action_needed.

Outlet entries use the states queued, preparing, scheduled, delivered, action_needed, removing, or removed. The operation field identifies whether the latest work is a delivery, redelivery, or takedown.

customer_state provides a presentation state that does not imply action unless attention_owner is customer and both action fields are present. Recovery-backed states report whether that recovery is queued or acknowledged.

outlets lists only outlets that have been queued for this release, and every entry carries the queue_id of the work it reports. An outlet that was never queued is absent from the list. delivered with operation delivery means LabelGrid completed the delivery to that outlet and no takedown has been queued there since. It reflects LabelGrid's delivery records, not a check of the store's catalog.

The release-level fields are derived from the same records:

• currently_live is true when at least one outlet's most recent completed work is a delivery or redelivery rather than a takedown. A single outlet still reading delivered keeps the release live even when every other outlet reads removed.
• ever_delivered is true when at least one delivery or redelivery has completed at any outlet. Completed takedowns do not count. For releases delivered before per-outlet history was recorded, the release's own distribution status supplies this value.
• ever_submitted is true once the release has been accepted for distribution or queued for any outlet.
• state takes the first matching value: action_needed when any outlet reads action_needed; removing when any outlet reads removing; live when currently_live is true; in_progress when any outlet reads queued, preparing or scheduled; removed when the release was delivered before or every outlet reads removed; in_progress when it was submitted; otherwise not_submitted.

A release outside your account returns 404 RELEASE_NOT_ACCESSIBLE, the same response as an unknown release. A status that cannot be safely determined returns 500 PROCESSING_ERROR.

Parameters

• releaseId (path)

Responses

• 200
• 401