# Get a folder

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

## `GET /media-folders/:id`

**Get a folder**

Returns a single folder with its contents and subfolders.

Required permissions: `media.view`

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `id` | path | string | Yes | Unique identifier |


### Responses

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


### Examples

```bash
curl https://api.lynkow.com/v1/media-folders/f1a2b3c4-d5e6-7890-abcd-ef1234567890 \
  -H "Authorization: Bearer $API_TOKEN"
```

### Response Example

```json
{
  "data": {
    "id": "f1a2b3c4-d5e6-7890-abcd-ef1234567890",
    "name": "Banners",
    "parentId": null,
    "mediaCount": 24,
    "children": [
      {
        "id": "f5e6f7a8-b9c0-1234-efab-567890123456",
        "name": "Homepage",
        "mediaCount": 8
      }
    ],
    "createdAt": "2025-01-15T09:00:00.000Z",
    "updatedAt": "2025-03-10T14:00:00.000Z"
  }
}
```

---