# List tasks
List recent tasks owned by the authenticated account. Follow before to read older tasks.
**Request:** `GET https://leadsagent.io/api/v1/tasks?limit=20`
**Access:** leads:read.
**Response:** data is an array of task summaries.

## Parameters

- `limit` (integer): Optional. 1–50; default 20.
- `before` (string): Optional. Cursor from the last item; an ISO timestamp or timestamp|UUID.

## cURL

```sh
curl --fail-with-body --silent --show-error --request GET "$LEADSAGENT_API_BASE/tasks?limit=20" -H "X-API-Key: $LEADSAGENT_API_KEY"
```

## Example response

```
{
  "request_id": "6c4d0c26-8aa3-44b0-a50a-51b832b29465",
  "status": "success",
  "data": [
    {
      "id": "73bd1ccb-1a44-4b41-84da-4ea7a5ad03f4",
      "kind": "agent",
      "status": "running",
      "prompt": "Find 20 dentists in Austin with emails",
      "source": "research-example",
      "max_leads": 20,
      "lead_count": 0,
      "created_at": "2026-10-21T12:00:00+00:00",
      "updated_at": "2026-10-21T12:00:00+00:00",
      "status_url": "/api/v1/tasks/73bd1ccb-1a44-4b41-84da-4ea7a5ad03f4"
    }
  ],
  "meta": {}
}
```

[Open the full API reference](https://leadsagent.io/documentation/api-reference)