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

# List Files

> List the files in a collection.

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.doctly.ai/api/v1/collections/{collection_id}/files?status=ready&limit=100" \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```
</RequestExample>

**GET** `/api/v1/collections/{collection_id}/files`

## Path Parameters

<ParamField path="collection_id" type="string" required>
  The collection's UUID.
</ParamField>

## Query Parameters

<ParamField query="skip" type="integer" default="0">
  Number of results to skip (offset pagination).
</ParamField>

<ParamField query="limit" type="integer" default="100">
  Maximum number of files to return.
</ParamField>

<ParamField query="status" type="string">
  Filter by status: `pending`, `processing`, `ready`, `failed`, or `stored`.
</ParamField>

<ParamField query="search" type="string">
  Case-insensitive substring match on the file path.
</ParamField>

<ParamField query="order_by" type="string" default="updated_at">
  Sort field: `file_name`, `status`, or `updated_at`.
</ParamField>

<ParamField query="order_dir" type="string" default="desc">
  Sort direction: `asc` or `desc`.
</ParamField>

## Response

<ResponseField name="data" type="array">
  Array of [file objects](/api-reference/collection-files/upload#the-file-object).
</ResponseField>

<ResponseField name="count" type="integer">
  Total number of files matching the filters.
</ResponseField>

<ResponseField name="has_more" type="boolean">
  Whether more results exist beyond this page.
</ResponseField>