## List Runs

**get** `/api/promptly/tasks/{taskId}/runs`

Retrieve run history for a specific task

### Path Parameters

- `taskId: string`

### Query Parameters

- `limit: optional number`

  Maximum number of runs to return

### Returns

- `id: optional string`

- `completedAt: optional string`

- `costCents: optional number`

  Cost in cents

- `createdAt: optional string`

- `deliveryStatus: optional "pending" or "delivered" or "failed"`

  - `"pending"`

  - `"delivered"`

  - `"failed"`

- `durationMs: optional number`

  Execution time in milliseconds

- `error: optional string`

  Error message if failed

- `output: optional string`

  AI-generated output

- `startedAt: optional string`

- `status: optional "pending" or "running" or "completed" or "failed"`

  - `"pending"`

  - `"running"`

  - `"completed"`

  - `"failed"`

- `taskId: optional string`

- `tokensUsed: optional number`

  Total tokens consumed

### Example

```http
curl https://0ct.com/api/promptly/tasks/$TASK_ID/runs \
    -H "Authorization: Bearer $0CT_API_KEY"
```