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

# List Files

Retrieve all files accessible to the authenticated user.

## Query Parameters

<ParamField query="file_type" type="string">
  Filter by file type: `document`, `image`, `video`, `audio`, `archive`, `code`, `data`, `other`
</ParamField>

<ParamField query="status" type="string">
  Filter by status: `uploading`, `active`, `archived`, `deleted`, `error`
</ParamField>

<ParamField query="search" type="string">
  Search files by filename
</ParamField>

<ParamField query="tags" type="array">
  Filter by tags (can specify multiple)
</ParamField>

<ParamField query="include_deleted" type="boolean">
  Include deleted files in results (default: false)
</ParamField>

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET "https://api.artaios.ai/api/v1/files/?file_type=document&status=active" \
    -H "x-api-key: YOUR_API_KEY"
  ```

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

  response = requests.get(
      "https://api.artaios.ai/api/v1/files/",
      headers={"x-api-key": "YOUR_API_KEY"},
      params={
          "file_type": "document",
          "status": "active"
      }
  )
  files = response.json()
  ```

  ```javascript JavaScript theme={null}
  const params = new URLSearchParams({
    file_type: 'document',
    status: 'active'
  });

  const response = await fetch(`https://api.artaios.ai/api/v1/files/?${params}`, {
    headers: {
      'x-api-key': 'YOUR_API_KEY'
    }
  });
  const files = await response.json();
  ```
</CodeGroup>

## Response

```json theme={null}
[
  {
    "id": "file_123",
    "original_filename": "product_manual.pdf",
    "file_type": "document",
    "size_bytes": 2048576,
    "status": "active",
    "tags": ["manual", "product"],
    "created_at": "2025-01-15T10:30:00Z",
    "updated_at": "2025-01-15T10:30:00Z"
  }
]
```