# GET /files
URL: https://developers.vsee.io/api/file-upload-api/get/files
Auth: User Token — Requires a user access token from login or SSO.

List files

Retrieve list of files with optional filtering

Parameters:
- X-ApiToken (header, string, required) — API token
- X-AccountCode (header, string, required) — Account code
- target_id (query, string, optional) — The ID of the target (user_id or visit_id)
- target_type (query, string, optional) — Target type (user or visit) [enum: user, visit]
- category_type (query, string, optional) — File category type (user_document, intake_attachment, user_consent, user_avatar)
- include_shared (query, boolean, optional) — Include shared files

Responses:
- 200 — Successful response
```json
{
  "data": [
    {
      "created": 1657668358,
      "creator": {
        "full_name": "Patient's Name",
        "type": 200,
        "username": "62ce09a2940adc6474"
      },
      "ext": "pdf",
      "fullpath": "https://api-vclinic.vsee.me/files/view/62ce0306-bd68-8fj3-7771-6dfc0ks8219474?auth_code=bb7e2d413f9jd93unf92u4e35584d10&time=1669924552",
      "id": "62ce0306-bd68-8fj3-7771-6dfc0ks8219474",
      "is_deletable": true,
      "meta": {
        "account": {
          "code": "vclinic"
        },
        "category": "user_document",
        "target": {
          "id": "2317820300",
          "type": "user"
        }
      },
      "name": "2017-01-21 04:00:00 - filename.pdf",
      "size": 274988
    }
  ]
}
```