# List orchestration runs

> Returns orchestration runs the caller can access, optionally filtered by orchestration, by parent run, by status, or by whether the run has a parent at all.

<Heading
  as={"h1"}
  className={"openapi__heading"}
  children={"List orchestration runs"}
>
</Heading>

<MethodEndpoint
  method={"get"}
  path={"/api/v1/orchestration-runs"}
  context={"endpoint"}
>
  
</MethodEndpoint>

Returns orchestration runs the caller can access, optionally filtered by orchestration, by parent run, by status, or by whether the run has a parent at all.

Note when aggregating: a run's `usage` covers its whole subtree, so summing it over a list that contains both a parent and its children counts the children more than once. Pass `nested=false` to sum over runs a caller started.

<Heading
  id={"request"}
  as={"h2"}
  className={"openapi-tabs__heading"}
>
  <Translate id="theme.openapi.request.title">Request</Translate>
</Heading>

<ParamsDetails
  {...require("./list-orchestration-runs.ParamsDetails.json")}
>
  
</ParamsDetails>

<RequestSchema
  {...require("./list-orchestration-runs.RequestSchema.json")}
>
  
</RequestSchema>

<StatusCodes
  {...require("./list-orchestration-runs.StatusCodes.json")}
>
  
</StatusCodes>