Get Single Folder
## Get Single Folder
Retrieves detailed information about a specific folder, including its **child folders and files**.
**Method:** `GET`
**URL:** `{{base_url}}/folders/{{folder_id}}`
---
## Authentication
This endpoint requires authentication.
Use a **Bearer token** in the `Authorization` header:
```http
Authorization: Bearer {{access_token}}
```
---
## Headers
| Header | Value |
|---|---|
| Authorization | Bearer {{access_token}} |
---
## Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `folder_id` | integer | Yes | Unique ID of the folder to retrieve |
Example:
```
{{base_url}}/folders/{{folder_id}}
```
---
## Required Variables
| Variable | Required | Description |
|---|---|---|
| `base_url` | Yes | Base API URL |
| `access_token` | Yes | Authentication access token |
| `folder_id` | Yes | ID of the folder to retrieve |
---
## Sample Request
```bash
curl --request GET "{{base_url}}/folders/{{folder_id}}" \
--header "Authorization: Bearer {{access_token}}"
```
---
## Sample Success Response
A successful request typically returns **HTTP 200 OK**.
```json
{
"success": true,
"data": {
"id": 11,
"user_id": "43028",
"name": "Campaign Photos",
"parent_id": 10,
"is_system": false,
"file_count": 0,
"created_at": "2026-03-10T06:25:32.000000Z",
"updated_at": "2026-03-10T06:25:32.000000Z",
"deleted_at": null,
"children": [],
"files": []
}
}
```
---
## Response Fields
| Field | Type | Description |
|---|---|---|
| `id` | integer | Folder ID |
| `user_id` | string | Owner user ID |
| `name` | string | Folder name |
| `parent_id` | integer/null | Parent folder ID |
| `is_system` | boolean | Indicates if it is a system folder |
| `file_count` | integer | Number of files in the folder |
| `created_at` | datetime | Folder creation timestamp |
| `updated_at` | datetime | Last update timestamp |
| `deleted_at` | datetime/null | Soft delete timestamp |
| `children` | array | List of child folders |
| `files` | array | Files stored inside the folder |
---
## Notes
- The `children` field contains **subfolders inside the current folder**.
- The `files` field contains **files stored in the folder**.
- Useful for building **folder view pages in file manager or gallery interfaces**.
- `file_count` provides a quick summary of how many files exist in the folder.
```
Response
OK
data
success