# GET /api/files

> Files - List Files of a context

- **Endpoint:** `GET /api/files`
- **Group:** Files
- **Since:** v1.0.0
- **Defined in:** `RestApi/Controllers/FilesController.php`

## Headers

| Field | Type | Description |
| --- | --- | --- |
| `authtoken` | String | Authentication token, generated from admin area |

## Parameters

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `context` | String | yes | Mandatory context. One of: project, client, global, user. RISE has no task file table, so tasks cannot be listed. |
| `context_id` | Number | no | Mandatory for project (project ID), client (client ID) and user (RISE user ID). Ignored for global. |
| `folder_id` | Number | no | Optional folder filter. Send 0 for the root of the context. |
| `category_id` | Number | no | Optional file category filter. Project context only. |
| `limit` | Number | no | Optional page size, 1 to 200. Default: `50`. |
| `offset` | Number | no | Optional number of rows to skip. Default: `0`. |

## Request example

```bash
curl -X GET "https://yoursite.com/index.php/api/files" \
  -H "authtoken: YOUR_API_TOKEN"
```

## Responses

### Success - Success-Response:

```json
HTTP/1.1 200 OK
[
  {
    "id": "12",
    "file_name": "file64b1c2-quote.pdf",
    "file_id": null,
    "service_type": null,
    "description": "Signed quote",
    "file_size": "20480",
    "created_at": "2026-07-23 09:15:00",
    "project_id": "4",
    "uploaded_by": "1",
    "category_id": "0",
    "folder_id": "0",
    "uploaded_by_user_name": "Jane Doe",
    "category_name": null,
    "source": "project"
  }
]
```

### Error - Error-Response:

```json
HTTP/1.1 400 Bad Request
{ "status": false, "messages": { "error": "Unknown context. Use one of: project, client, global, user." } }
```

---

Part of the [REST API for RISE CRM](https://risecrm.themesic.com/apiguide/) documentation.
Full page: https://risecrm.themesic.com/apiguide/files/get-files/