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:

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

curl --request GET "{{base_url}}/folders/{{folder_id}}" \
  --header "Authorization: Bearer {{access_token}}"

Sample Success Response

A successful request typically returns HTTP 200 OK.

{
  "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

dataobject

successboolean