# Folders (/en/docs/api/native/media/folders)



[Guide →](/en/docs/developers/services/media/quickstart)

[Base URL and authentication](/en/docs/api/native/media)

## List folders [#list-folders]

`GET /media/v1/libraries/{library_id}/folders`

| Parameter | Location | Type | Description |
| --- | --- | --- | --- |
| library_id | path | string | Library ID |
| parent | query | string | Parent folder path; omit or use an empty string for the root. Returns every child folder of that level at once without paging; limit or cursor returns 400 |

Returns: `Folders`.

### Response [#response]

#### HTTP 200 [#http-200]

Successful response.

**application/json**

| Name | Type | Description |
| --- | --- | --- |
| folders | array<object> | All immediate child folders of parent, sorted by path. |
| folders[].name | string | Final path segment naming the child folder. |
| folders[].path | string | Full folder path relative to the library root. |
| folders[].asset_count | number | Number of assets in this folder and all descendant folders. |

```bash
curl -X GET "https://api.deepraxis.ai/media/v1/libraries/${LIBRARY_ID}/folders" \
  -H "Authorization: Bearer $PRAXIS_API_KEY"
```

HTTP 200

```json
{
  "folders": [
    {
      "name": "examples",
      "path": "examples",
      "asset_count": 1
    }
  ]
}
```

## Folders [#folders]

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| folders | object[] | yes | Folders |