---
title: "List files (v2)"
method: GET
path: "/v2/files/"
tags: ["Files"]
---

# List files (v2)

`GET /v2/files/`

## Request

- Base URL: `https://api.chat.ethora.com`
- URL: `https://api.chat.ethora.com/v2/files/`
- Auth: HTTP bearer

**Auth**: User JWT

Get files created by user (JWT owner) (v2).
v2 canonical: returns `{ results, pagination }`.
For backward compatibility it also includes legacy-friendly keys `{ limit, offset, total, items }`.

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

```
{
  results: [{
    userId: string,
    ownerKey: string,
    location: string,
    locationPreview?: string,
    duration?: string,
    originalname: string,
    filename: string,
    mimetype: string,
    size: string,
    expiresAt: string,
    isPrivate: string,
    _id: string,
    createdAt: string,
    updatedAt: string,
  }],
  pagination: { limit: number, offset: number, total: number },

  // legacy-friendly keys (still present):
  limit: number,
  offset: number,
  total: number,
  items: array,
}
```

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `422`: Unprocessable Entity
- `500`: Internal Server Error

---

[API](https://skmtc.dev/ethora/apis/platform-api.md) · [All operations](https://skmtc.dev/ethora/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ethora/apis/platform-api/revisions/01b6e64378ee?raw)