# Get orchestration queue stats

> Returns a point-in-time snapshot of the orchestration run queue: how many tasks are waiting to be claimed (`queue_depth`), how many are currently claimed with a valid lease (`claimed_tasks`), the age of the oldest waiting task, recent claim-latency percentiles over a rolling in-process window, and a per-project breakdown. Intended for admin/operator policies; guarded by `orchestrations:GetQueueStats`.

<Heading
  as={"h1"}
  className={"openapi__heading"}
  children={"Get orchestration queue stats"}
>
</Heading>

<MethodEndpoint
  method={"get"}
  path={"/api/v1/orchestrations/queue/stats"}
  context={"endpoint"}
>
  
</MethodEndpoint>

Returns a point-in-time snapshot of the orchestration run queue: how many tasks are waiting to be claimed (`queue_depth`), how many are currently claimed with a valid lease (`claimed_tasks`), the age of the oldest waiting task, recent claim-latency percentiles over a rolling in-process window, and a per-project breakdown. Intended for admin/operator policies; guarded by `orchestrations:GetQueueStats`.
Every figure is scoped to what the caller may see. A project-scoped caller gets `per_project` for their own projects only, `queue_depth` and `claimed_tasks` summed over those same projects, and `null` for `oldest_queued_age_seconds` and the `claim_latency_ms` percentiles — both describe the whole deployment and cannot be narrowed, so they are withheld rather than approximated. An unrestricted caller (the action granted on every project) gets the deployment-wide figures.

<ParamsDetails>
  
</ParamsDetails>

<RequestSchema
  {...require("./get-queue-stats.RequestSchema.json")}
>
  
</RequestSchema>

<StatusCodes
  {...require("./get-queue-stats.StatusCodes.json")}
>
  
</StatusCodes>