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

# Session Logs

> The Unreal Engine log files captured for a session.

List the Unreal Engine log files captured from the streaming server when a session's application exited. Usually one per session. Fetch the content with [Download Log](/resources/api-reference/download-log).

<Info>
  Scope: `read`. A session whose application never started has no log; a session that is still running has not uploaded one yet.
</Info>

## Path parameters

<ParamField path="sessionId" type="string" required>
  The session.
</ParamField>

## Query parameters

<ParamField query="projectId" type="string" required>
  The project the session belongs to.
</ParamField>

<ParamField query="limit" type="integer" default="50">Files to return.</ParamField>
<ParamField query="skip" type="integer" default="0">Offset.</ParamField>

## Headers

<ParamField header="x-api-key" type="string" required>
  Your Streampixel API key.
</ParamField>

## Response

<ResponseField name="total" type="number">Log files for the session.</ResponseField>

<ResponseField name="logFiles" type="array">
  <Expandable title="Log file fields">
    <ResponseField name="_id" type="string">Log file id, for [Download Log](/resources/api-reference/download-log).</ResponseField>
    <ResponseField name="fileName" type="string">Original file name.</ResponseField>
    <ResponseField name="fileSize" type="number">Uncompressed size in bytes.</ResponseField>
    <ResponseField name="gzSize" type="number">Stored (compressed) size.</ResponseField>
    <ResponseField name="uploadedAt" type="string">ISO 8601.</ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={"dark"}
  curl "https://platform.streampixel.io/api/v1/analytics/log-files/session/session_1790294409382_3035?projectId=664f1a2b3c4d5e6f7a8b9c0d" \
    -H "x-api-key: $STREAMPIXEL_API_KEY"
  ```

  ```javascript Node.js theme={"dark"}
  const u = new URL('https://platform.streampixel.io/api/v1/analytics/log-files/session/session_1790294409382_3035');
  u.searchParams.set('projectId', '664f1a2b3c4d5e6f7a8b9c0d');
  const { logFiles } = await (await fetch(u, { headers: { 'x-api-key': process.env.STREAMPIXEL_API_KEY } })).json();
  ```

  ```python Python theme={"dark"}
  import os, requests

  r = requests.get(
      "https://platform.streampixel.io/api/v1/analytics/log-files/session/session_1790294409382_3035",
      params={"projectId": "664f1a2b3c4d5e6f7a8b9c0d"},
      headers={"x-api-key": os.environ["STREAMPIXEL_API_KEY"]},
  )
  print(r.json()["logFiles"])
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={"dark"}
  {
    "success": true,
    "sessionId": "session_1790294409382_3035",
    "total": 1,
    "count": 1,
    "logFiles": [
      {
        "_id": "66b1c2d3e4f5a6b7c8d9e0f1",
        "sessionId": "session_1790294409382_3035",
        "projectId": "664f1a2b3c4d5e6f7a8b9c0d",
        "fileName": "Showroom.log",
        "fileSize": 1843210,
        "gzSize": 122087,
        "uploadedAt": "2026-09-25T14:31:52.000Z"
      }
    ]
  }
  ```
</ResponseExample>

## Errors

| Status | Cause                                                                          |
| ------ | ------------------------------------------------------------------------------ |
| `403`  | `projectId` missing, or the session belongs to a different project or account. |