# List Runs API

Retrieve runs for your team. You can optionally filter by `task_key` and page
			through results with a cursor.

  GET  `/v1/runs/list?task_key={task_key}` 

## Query Parameters

- `task_key` filters runs to a single task.

- `limit` controls page size.

- `cursor` continues from the previous page.

## Example

```bash
curl -X GET "https://api-ingress-worker-staging.browsable-staging.workers.dev/v1/runs/list?task_key=reddit-search&limit=20" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## Response

```json
{
  "runs": [
    {
      "run_id": "00000000-0000-4000-8000-000000000001",
      "task_key": "reddit-search",
      "task_name": "Reddit Search",
      "run_status": "succeeded",
      "status_url": "/v1/runs/00000000-0000-4000-8000-000000000001",
      "result": {"count": 25, "results": []},
      "error": null,
      "created_at": "2024-01-20T10:30:00Z"
    }
  ],
  "pagination": {
    "has_more": false,
    "next_cursor": null,
    "previous_cursor": null
  }
}
```

---
Source: https://browsable-api-ux-staging.pages.dev/docs/api/runs/list