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

# Seznam souborů

> Načtení stránkovaného seznamu vašich nahraných souborů.

## Query parametry

<ParamField query="page" type="integer" default="1">
  Číslo stránky pro stránkování.
</ParamField>

<ParamField query="limit" type="integer" default="25">
  Počet položek na stránku (max 100).
</ParamField>

## Odpověď

<ResponseField name="data" type="array">
  <Expandable title="Objekt souboru">
    <ResponseField name="id" type="string">Jedinečný identifikátor souboru.</ResponseField>
    <ResponseField name="filename" type="string">Původní název souboru.</ResponseField>
    <ResponseField name="size" type="integer">Velikost souboru v bajtech.</ResponseField>
    <ResponseField name="content_type" type="string">MIME typ souboru.</ResponseField>
    <ResponseField name="created_at" type="string">Časové razítko ISO 8601.</ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="pagination" type="object">
  <Expandable title="Metadata stránkování">
    <ResponseField name="page" type="integer">Aktuální stránka.</ResponseField>
    <ResponseField name="limit" type="integer">Položek na stránku.</ResponseField>
    <ResponseField name="total" type="integer">Celkový počet souborů.</ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```typescript TypeScript theme={null}
  const result = await client.files.list({ page: 1, limit: 10 });

  for (const file of result.data) {
    console.log(`${file.filename} (${file.size} bytes)`);
  }
  ```

  ```python Python theme={null}
  result = client.files.list(page=1, limit=10)

  for file in result["data"]:
      print(f"{file['filename']} ({file['size']} bytes)")
  ```

  ```bash cURL theme={null}
  curl -X GET "https://hub.banditshq.com/api/v1/files?page=1&limit=10" \
    -H "Authorization: Bearer lasso_..."
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "data": [
      {
        "id": "file_abc123",
        "filename": "catalog.pdf",
        "size": 1048576,
        "content_type": "application/pdf",
        "created_at": "2025-03-10T14:30:00.000Z"
      }
    ],
    "pagination": { "page": 1, "limit": 10, "total": 5 }
  }
  ```
</ResponseExample>