> ## Documentation Index
> Fetch the complete documentation index at: https://docs.60db.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List Simulations

> List the simulation runs of an agent, newest first

> [!NOTE]
>
> AI Simulation needs an active **Pro** or **Business** plan. On another plan, every simulation endpoint returns `403 POLICY_DENY`.

List the runs started for one agent. The list comes from 60db's own index, so it shows only runs of your workspace.

## Request

### Headers

**Authorization** `string` *required*

Bearer token with your API key (scope `agents`)

### Path

**agentId** `string` *required*

The agent `id` (UUID). The agent must be in your workspace and saved at least once

### Query

**limit** `integer` (default: 50)

1 to 100

**offset** `integer` (default: 0)

Rows to skip

## Response

**200 OK**. `data` is a list. `pagination` has `total`, `limit` and `offset`.

```json theme={null}
{
  "success": true,
  "data": [
    {
      "run_id": "6f1c1e2a-3333-4000-8000-000000000001",
      "agent_id": "6f1c1e2a-1111-4000-8000-000000000001",
      "kind": "generated",
      "state": "finished",
      "total": 24,
      "draft_id": null,
      "estimated_credits": 12,
      "max_credits": 20,
      "created_at": "2026-11-15T06:10:00.000Z"
    }
  ],
  "pagination": { "total": 1, "limit": 50, "offset": 0 }
}
```

`kind` is `generated`, `custom`, `rerun` or `call_rerun`. `state` is the last state 60db saw. It updates when you read the run.

## Errors

| Status | Code | Meaning |
| - | - | - |
| 403 | `POLICY_DENY` | Your role cannot read agents, the workspace is not on an active Pro or Business plan, or the API key lacks the `agents` scope |
| 404 | `AGENT_NOT_FOUND` | No agent with this ID in your workspace |

## Example

```bash cURL theme={null}
curl "https://api.60db.ai/agents/AGENT_ID/simulations?limit=20" \
  -H "Authorization: Bearer your-api-key"
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.