# List media files

**Publié le** : 2026-05-08
**Catégorie** : Media & Files

## `GET /media`

**List media files**

Returns a paginated list of media files. Supports filtering by folder,
file type, and search. Excludes trashed files.

Required permissions: `media.view`

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `page` | query | number | No | Number |
| `limit` | query | number | No | Number <= 100 |
| `search` | query | string | No | Full-text search query |
| `sortBy` | query | "created_at" \| "updated_at" \| "filename" \| "size" | No | One of: created_at, updated_at, filename, size |
| `sortOrder` | query | "asc" \| "desc" | No | One of: asc, desc |
| `dateFrom` | query | string | No | Filter from date (ISO 8601) |
| `dateTo` | query | string | No | Filter until date (ISO 8601) |
| `mimeType` | query | string | No | MIME type (e.g. image/jpeg) |
| `sizeMin` | query | number | No | Number |
| `sizeMax` | query | number | No | Number |
| `ids` | query | string[] | No | Array of strings |
| `excludeIds` | query | string[] | No | Array of strings |
| `folderId` | query | string | No | Media folder UUID |


### Responses

| Status | Description |
| --- | --- |
| `200` | Successful response |
| `401` | Unauthorized — invalid or missing API token |
| `403` | Forbidden — insufficient permissions |


### Examples

```bash
# List images in a specific folder
curl "https://api.lynkow.com/v1/media?folderId=uuid-of-folder&type=image" \
  -H "Authorization: Bearer $API_TOKEN"
```

### Response Example

```json
{
  "data": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "filename": "hero-banner.jpg",
      "originalName": "hero-banner.jpg",
      "mimeType": "image/jpeg",
      "size": 245760,
      "width": 1920,
      "height": 1080,
      "alt": "Homepage hero banner",
      "url": "https://cdn.lynkow.com/sites/abc123/hero-banner.jpg",
      "variants": {
        "thumbnail": "https://cdn.lynkow.com/sites/abc123/hero-banner.jpg?w=150",
        "card": "https://cdn.lynkow.com/sites/abc123/hero-banner.jpg?w=400",
        "content": "https://cdn.lynkow.com/sites/abc123/hero-banner.jpg?w=800",
        "medium": "https://cdn.lynkow.com/sites/abc123/hero-banner.jpg?w=1200"
      },
      "folderId": "folder-uuid",
      "createdAt": "2025-02-10T12:00:00.000Z"
    }
  ],
  "meta": {
    "total": 156,
    "perPage": 15,
    "currentPage": 1,
    "lastPage": 11
  }
}
```

---