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

# List Session Logs

> Retrieve a paginated list of session logs.

Retrieve session execution logs with pagination and filtering. Use this to monitor flow executions, track errors, and audit session activity.

<ParamField header="X-Api-Key" type="string" required>
  Your API key (prefixed with `wh_`).
</ParamField>

<ParamField query="page" type="integer" default="0">
  Page number (zero-based).
</ParamField>

<ParamField query="size" type="integer" default="10">
  Number of items per page (1-100).
</ParamField>

<ParamField query="orderBy" type="string">
  Column name to order results by.
</ParamField>

<ParamField query="direction" type="string" default="ASC">
  Sort direction. `ASC` or `DESC`.
</ParamField>

<ParamField query="workspaceId" type="string">
  Filter by workspace UUID.
</ParamField>

<ParamField query="dateRange" type="string">
  Filter by date range. One of `today`, `last7days`, `last15days`, `last30days`.
</ParamField>

<ParamField query="sessionId" type="string">
  Filter by a specific session UUID.
</ParamField>

<ParamField query="status" type="string">
  Filter by session status. One of `running`, `completed`, `timeout`, `error`.
</ParamField>

<RequestExample>
  ```bash theme={null}
  curl -X GET "https://api.whatabot.app/api/v1/sessions/logs?page=0&size=10" \
    -H "X-Api-Key: wh_your_api_key"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "content": [
      {
        "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "workspaceId": "660e8400-e29b-41d4-a716-446655440000",
        "flowId": "550e8400-e29b-41d4-a716-446655440000",
        "externalId": "contact-123",
        "status": "completed",
        "warnings": 0,
        "startedAt": "2025-01-15T10:30:00.000Z",
        "expiresAt": "2025-01-15T10:45:00.000Z",
        "finishedAt": "2025-01-15T10:32:15.000Z"
      }
    ],
    "totalElements": 1,
    "totalPages": 1,
    "number": 0,
    "size": 10,
    "first": true,
    "last": true
  }
  ```
</ResponseExample>