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

# List Session Files

> List files uploaded to the session.

## Overview

Returns every file currently present in the session's uploads directory, in no guaranteed order. Uploaded files persist for the life of the session and can be referenced by name in `uploadFile` task actions.

## Path Parameters

<ParamField path="id" type="string" required={true}>
  Browser session ID (UUID).
</ParamField>

## Example Request

<CodeGroup>
  ```bash cURL theme={null}
  curl -G "https://api.scrapengine.io/api/v1/browser/sessions/baa3f390-fa6e-4a24-b84a-a575a5f3a9c7/files" \
    -H "Authorization: Bearer $SCRAPENGINE_API_KEY"
  ```

  ```python Python theme={null}
  import os, requests

  response = requests.get(
      "https://api.scrapengine.io/api/v1/browser/sessions/baa3f390-fa6e-4a24-b84a-a575a5f3a9c7/files",
      headers={"Authorization": f"Bearer {os.environ['SCRAPENGINE_API_KEY']}"},
  )
  data = response.json()
  ```
</CodeGroup>

## Response

### Success Response (200)

<ResponseField name="files" type="array">
  Array of uploaded file records. Each entry contains:

  * `filename` (string) — name in the uploads directory.
  * `size` (integer) — size in bytes.
  * `uploadedAt` (string) — ISO 8601 timestamp of the upload.
</ResponseField>

**Example Response:**

```json theme={null}
{
  "files": [
    {
      "filename": "resume.pdf",
      "size": 20813,
      "uploadedAt": "2026-04-24T09:12:44Z"
    }
  ]
}
```

### Error Responses

| Status | Description                                   |
| ------ | --------------------------------------------- |
| `401`  | Unauthorized — invalid or missing API key.    |
| `404`  | Session not found or not owned by the caller. |