Get Files List

## Get Files List Retrieve a list of files in a folder, with optional filtering/search and sorting. ### Endpoint `GET {{base_url}}/files` ### Authentication This endpoint requires **Bearer Token** authentication. - Header: `Authorization: Bearer {{access_token}}` > Ensure `{{access_token}}` is set to a valid JWT/token value in the active environment or collection variables. ### Query parameters | Parameter | Required | Type | Description | | --- | --- | --- | --- | | `folder_id` | Yes | string/number | Folder identifier to list files from. | | `search` | No | string | Search term to filter files (e.g., filename). | | `starred` | No | boolean (`true`/`false`) | Filter for starred files. | | `trashed` | No | boolean (`true`/`false`) | Filter for trashed files. | | `sort` | No | string | Sort order (e.g., `date`). | ### Example request URL ``` text {{base_url}}/files?folder_id={{folder_id}}&search=Frame 1000003420.png&starred=false&trashed=false&sort=date ``` ### Example response (outline) ``` json { "status": "OK", "data": { "files": [ { "id": "<file_id>", "name": "<filename>", "url": "<file_url>", "mime_type": "<mime_type>", "size": <bytes>, "starred": false, "trashed": false, "created_at": "<timestamp>", "updated_at": "<timestamp>" } ], "pagination": { "page": 1, "per_page": 20, "total": <count> } } } ```