---
title: "List loop runs for a definition"
method: GET
path: "/api/v1/loops/{id}/runs"
tags: ["Loops"]
---

# List loop runs for a definition

`GET /api/v1/loops/{id}/runs`

## Request

- Base URL: `https://arcadeops.leadalpes.fr`
- URL: `https://arcadeops.leadalpes.fr/api/v1/loops/{id}/runs`
- Auth: none declared

List loop runs for a definition.

## Path parameters

- `id` string, required

## Query parameters

- `limit` number
- `cursor` string

## Response `200`

List

- object
  - `items` object[], required
    - `id` string, required
    - `orgId` string, required
    - `loopDefinitionId` string, required
    - `iteration` integer, required
    - `status` 'QUEUED' | 'RUNNING' | 'SUCCEEDED' | 'FAILED' | 'CANCELLED' | 'BLOCKED_EVAL', required
    - `triggerType` 'MANUAL' | 'SCHEDULE' | 'EVENT', required
    - `taskId` string, nullable, required
    - `agentRunId` string, nullable, required
    - `evalResult` unknown
    - `costMicros` string, nullable, required
    - `error` string, nullable, required
    - `startedAt` string, nullable, required
    - `endedAt` string, nullable, required
    - `sourceLearnRecordId` string, nullable, required
    - `createdAt` string, required
    - `updatedAt` string, required
  - `nextCursor` string, nullable, required

---

[API](https://skmtc.dev/leadalpes/apis/arcadeops-api.md) · [All operations](https://skmtc.dev/leadalpes/apis/arcadeops-api/llms.txt) · [OpenAPI document](https://skmtc.dev/leadalpes/apis/arcadeops-api/revisions/f10422ec7412?raw)