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

# List Workflow Logs

> Read execution logs for one workflow run.

List Workflow Logs returns paginated execution logs for a workflow run.

## Authentication

Requires an API key in the `Authorization` header.

## Request

<ParamField query="run_id" type="string" required>
  The workflow run ID.
</ParamField>

<ParamField query="limit" type="integer" default="100">
  Number of logs to return. Maximum `100`.
</ParamField>

<ParamField query="offset" type="integer" default="0">
  Number of logs to skip.
</ParamField>

```bash theme={"theme":{"light":"github-light","dark":"vesper"}}
curl "https://developer.encrata.com/api/workflows/logs?run_id=d4e5f6a1-7b8c-4d9e-8f10-1a2b3c4d5e6f&limit=100&offset=0" \
  -H "Authorization: Bearer enc_xxxxxxxxxxxx"
```

## Response

<ResponseField name="logs" type="object[]">
  The matching log entries. Each entry can contain `id`, `workflow_id`,
  `run_id`, `step_id`, `level`, `message`, `metadata`, and `created_at`.
</ResponseField>

<ResponseField name="total" type="integer">
  Total logs for the run.
</ResponseField>

<ResponseField name="limit" type="integer">
  Applied page size.
</ResponseField>

<ResponseField name="offset" type="integer">
  Applied offset.
</ResponseField>

<Note>
  `metadata` is a JSON-encoded string. Parse it separately when you need its
  structured values.
</Note>

```json theme={"theme":{"light":"github-light","dark":"vesper"}}
{
  "logs": [
    {
      "id": "log_01J9W6Q9E8PW4V9N7T3K2M1R5A",
      "workflow_id": "6f1c2e94-2b6a-4a1e-9b3a-6c9f0f2a1d77",
      "run_id": "d4e5f6a1-7b8c-4d9e-8f10-1a2b3c4d5e6f",
      "level": "info",
      "message": "Workflow run completed",
      "metadata": "{\"credits_used\":2}",
      "created_at": "2026-10-07T15:13:34Z"
    }
  ],
  "total": 1,
  "limit": 100,
  "offset": 0
}
```

## Errors

| Status | Cause |
| - | - |
| `400` | `run_id` is missing |
| `401` | The API key is missing or invalid |
| `405` | The request did not use `GET` |
| `500` | Logs could not be read |


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