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

# List Files

> List passive PDF file assets.

## Overview

Files are passive private assets. They do not automatically start document parsing. Use them when you want to upload once and later host, convert, or run a workflow.

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

<ParamField query="cursor" type="string">
  Pagination cursor from a previous response.
</ParamField>

<RequestExample>
  ```bash theme={null}
  curl https://api.okrapdf.com/v1/files \
    -H "Authorization: Bearer $OKRA_API_KEY"
  ```
</RequestExample>