> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://apidocs.me-mate.net/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://apidocs.me-mate.net/_mcp/server. # Get Folders List GET https://business.me-mate.net/partners/wp-gallery/manage/folders ## Get Folders List Retrieves the list of folders for the authenticated user.\ You can optionally filter folders by **parent folder ID**. **Method:** `GET`\ **URL:** `{{base_url}}/folders` *** ## 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}} | *** ## Query Parameters | Parameter | Type | Required | Description | | ----------- | ------- | -------- | ---------------------------------------------------------------------------------------------------------------- | | `parent_id` | integer | No | Filter folders by parent folder ID. If omitted, returns all folders or root folders depending on implementation. | Example: ``` {{base_url}}/folders?parent_id={{parent_id}} ``` *** ## Required Variables | Variable | Required | Description | | -------------- | -------- | ----------------------------------- | | `base_url` | Yes | Base API URL | | `access_token` | Yes | Authentication access token | | `parent_id` | No | Parent folder ID used for filtering | *** ## Sample Request ```bash curl --request GET "{{base_url}}/folders?parent_id={{parent_id}}" \ --header "Authorization: Bearer {{access_token}}" ``` *** ## Sample Success Response A successful request typically returns **HTTP 200 OK**. ```json { "success": true, "data": [ { "id": 8, "user_id": "43028", "name": "Campaign Photos", "parent_id": 5, "is_system": false, "file_count": 2, "created_at": "2026-03-09T11:24:52.000000Z", "updated_at": "2026-03-09T13:27:18.000000Z", "deleted_at": null, "children": [] }, { "id": 9, "user_id": "43028", "name": "test", "parent_id": null, "is_system": false, "file_count": 1, "created_at": "2026-03-09T13:09:49.000000Z", "updated_at": "2026-03-10T06:23:09.000000Z", "deleted_at": null, "children": [ { "id": 10, "user_id": "43028", "name": "test2", "parent_id": 9, "is_system": false, "file_count": 14, "created_at": "2026-03-09T13:10:07.000000Z", "updated_at": "2026-03-10T05:34:50.000000Z", "deleted_at": null } ] }, { "id": 10, "user_id": "43028", "name": "test2", "parent_id": 9, "is_system": false, "file_count": 14, "created_at": "2026-03-09T13:10:07.000000Z", "updated_at": "2026-03-10T05:34:50.000000Z", "deleted_at": null, "children": [] } ] } ``` *** ## 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 | *** ## Notes * The `children` field contains **nested subfolders**. * `parent_id = null` indicates a **root-level folder**. * Useful for building **folder tree structures** in file manager UIs. * The `file_count` field indicates how many files exist in each folder. Reference: https://apidocs.me-mate.net/business-me-mate-net-ap-is-document-v-1-0/messenger-mate-gallery-app-file-upload-folder-management-api/folder-management-ap-is/get-folders-list ## Response ### 200 OK - `data` (list of object, required) - `id` (integer, required) - `name` (string, required) - `user_id` (string, required) - `children` (list of any, required) - `is_system` (boolean, required) - `parent_id` (integer, required) - `created_at` (datetime, required) - `file_count` (integer, required) - `updated_at` (datetime, required) - `deleted_at` (any, optional, nullable) - `success` (boolean, required) ## Examples **Response** ```json { "data": [ { "id": 8, "name": "Campaign Photos", "user_id": "43028", "children": [], "is_system": false, "parent_id": 5, "created_at": "2026-03-09T11:24:52Z", "file_count": 2, "updated_at": "2026-03-09T13:27:18Z" }, { "id": 9, "name": "test", "user_id": "43028", "children": [ { "created_at": "2026-03-09T13:10:07.000000Z", "file_count": 14, "id": 10, "is_system": false, "name": "test2", "parent_id": 9, "updated_at": "2026-03-10T05:34:50.000000Z", "user_id": "43028" } ], "is_system": false, "parent_id": 1, "created_at": "2026-03-09T13:09:49Z", "file_count": 1, "updated_at": "2026-03-10T06:23:09Z" }, { "id": 10, "name": "test2", "user_id": "43028", "children": [], "is_system": false, "parent_id": 9, "created_at": "2026-03-09T13:10:07Z", "file_count": 14, "updated_at": "2026-03-10T05:34:50Z" } ], "success": true } ``` **SDK Code** ```python import requests url = "https://business.me-mate.net/partners/wp-gallery/manage/folders" response = requests.get(url) print(response.json()) ``` ```javascript const url = 'https://business.me-mate.net/partners/wp-gallery/manage/folders'; const options = {method: 'GET'}; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go package main import ( "fmt" "net/http" "io" ) func main() { url := "https://business.me-mate.net/partners/wp-gallery/manage/folders" req, _ := http.NewRequest("GET", url, nil) res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby require 'uri' require 'net/http' url = URI("https://business.me-mate.net/partners/wp-gallery/manage/folders") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```java import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.get("https://business.me-mate.net/partners/wp-gallery/manage/folders") .asString(); ``` ```php request('GET', 'https://business.me-mate.net/partners/wp-gallery/manage/folders'); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://business.me-mate.net/partners/wp-gallery/manage/folders"); var request = new RestRequest(Method.GET); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let request = NSMutableURLRequest(url: NSURL(string: "https://business.me-mate.net/partners/wp-gallery/manage/folders")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "GET" let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```