read.internal.shipment_queue

The live parcel queue for an operator, optionally narrowed to one store: how many parcels are still at the bench (split into those ready to go and those held because this instance requires a document attached to a parcel before dispatch), how many wait on the pickup shelf uncollected, how many of each have been waiting longer than the caller’s threshold, and the oldest stamp in each line. A state, never a window: nothing here obeys a period. Parcel stages are derived from facts — this schema has no status column.

• Surface: GET /v1/read/internal/shipment_queue · MCP tool read.internal.shipment_queue
• Auth: ★ Internal read (operator) — a tenant credential is REQUIRED; requires ANY ONE of order.read, order.write. The tenant is resolved from the CALLER’s identity, never from store. Personal fields come back MASKED for an actor without pii.read (the shape is unchanged).

Params (JSON Schema)

{
  "properties": {
    "stale_after_days": {
      "maximum": 365,
      "minimum": 1,
      "type": "integer"
    },
    "store_id": {
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "stale_after_days"
  ],
  "type": "object"
}

Result (200)

Open (unknown) — this capability does not declare an output schema.

Errors

validation_failed (400) · not_found (404) · unauthorized (401) · forbidden (403)