> 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 Files List GET https://business.me-mate.net/partners/wp-gallery/manage/files ## Get Files List Retrieve a list of files in a folder, with optional filtering/search and sorting. ### Endpoint `GET {{base_url}}/files` ### Authentication This endpoint requires **Bearer Token** authentication. * Header: `Authorization: Bearer {{access_token}}` > Ensure `{{access_token}}` is set to a valid JWT/token value in the active environment or collection variables. ### Query parameters | Parameter | Required | Type | Description | | ----------- | -------- | ------------------------ | --------------------------------------------- | | `folder_id` | Yes | string/number | Folder identifier to list files from. | | `search` | No | string | Search term to filter files (e.g., filename). | | `starred` | No | boolean (`true`/`false`) | Filter for starred files. | | `trashed` | No | boolean (`true`/`false`) | Filter for trashed files. | | `sort` | No | string | Sort order (e.g., `date`). | ### Example request URL ```text {{base_url}}/files?folder_id={{folder_id}}&search=Frame 1000003420.png&starred=false&trashed=false&sort=date ``` ### Example response (outline) ```json { "status": "OK", "data": { "files": [ { "id": "", "name": "", "url": "", "mime_type": "", "size": , "starred": false, "trashed": false, "created_at": "", "updated_at": "" } ], "pagination": { "page": 1, "per_page": 20, "total": } } } ``` 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/file-upload-ap-is/get-files-list ## Request ### Query parameters - `folder_id` (string, optional) - `search` (string, optional) - `starred` (boolean, optional) - `trashed` (boolean, optional) ## Response ### 200 OK - `data` (object, required) - `to` (integer, required) - `data` (list of object, required) - `id` (integer, required) - `url` (string, required) - `hash` (string, required) - `name` (string, required) - `path` (string, required) - `size` (integer, required) - `tags` (list of any, required) - `type` (string, required) - `folder` (object, required) - `id` (integer, required) - `name` (string, required) - `user_id` (string, 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) - `user_id` (string, required) - `extension` (string, required) - `folder_id` (integer, required) - `mime_type` (string, required) - `created_at` (datetime, required) - `is_starred` (boolean, required) - `updated_at` (datetime, required) - `uploaded_at` (datetime, required) - `original_name` (string, required) - `is_whatsapp_compatible` (boolean, required) - `whatsapp_compatibility_reason` (string, required) - `path_hash` (any, optional, nullable) - `deleted_at` (any, optional, nullable) - `from` (integer, required) - `path` (string, required) - `links` (list of object, required) - `label` (string, required) - `active` (boolean, required) - `url` (any, optional, nullable) - `page` (any, optional, nullable) - `total` (integer, required) - `per_page` (integer, required) - `last_page` (integer, required) - `current_page` (integer, required) - `last_page_url` (string, required) - `first_page_url` (string, required) - `next_page_url` (any, optional, nullable) - `prev_page_url` (any, optional, nullable) - `success` (boolean, required) - `total_trash_count` (integer, required) - `total_starred_count` (integer, required) ## Examples **Response** ```json { "data": { "to": 12, "data": [ { "id": 34, "url": "https://business.me-mate.net/getgabs-uploads/cdngallery/9f86443bd9f2ad28d1be4b62e8783e96720ec87a2ba86fcbeb5fc537483bf05b/files/5/MEL37P9ilmLodrQg.png", "hash": "b302a431204139c0572ab43b0d2bbc71297e8e1c21445d8daa786126de2d1cb1", "name": "Frame 1000003420.png", "path": "cdngallery/9f86443bd9f2ad28d1be4b62e8783e96720ec87a2ba86fcbeb5fc537483bf05b/files/5/MEL37P9ilmLodrQg.png", "size": 87963, "tags": [], "type": "image", "folder": { "id": 10, "name": "test2", "user_id": "43028", "is_system": false, "parent_id": 9, "created_at": "2026-03-09T13:10:07Z", "file_count": 14, "updated_at": "2026-03-10T05:34:50Z" }, "user_id": "43028", "extension": "png", "folder_id": 10, "mime_type": "image/png", "created_at": "2026-03-10T04:37:27Z", "is_starred": false, "updated_at": "2026-03-10T04:37:27Z", "uploaded_at": "2026-03-10T04:37:27Z", "original_name": "Frame 1000003420.png", "is_whatsapp_compatible": true, "whatsapp_compatibility_reason": "Ready for WhatsApp" }, { "id": 35, "url": "https://business.me-mate.net/getgabs-uploads/cdngallery/9f86443bd9f2ad28d1be4b62e8783e96720ec87a2ba86fcbeb5fc537483bf05b/files/5/Hj5UkEryJNCXtHwY.png", "hash": "3851267a8d31f9f92e03bc00d936bfbe42138b71a986312ca16b8230d38fdbda", "name": "Frame 1000003420 (1).png", "path": "cdngallery/9f86443bd9f2ad28d1be4b62e8783e96720ec87a2ba86fcbeb5fc537483bf05b/files/5/Hj5UkEryJNCXtHwY.png", "size": 40483, "tags": [], "type": "image", "folder": { "id": 10, "name": "test2", "user_id": "43028", "is_system": false, "parent_id": 9, "created_at": "2026-03-09T13:10:07Z", "file_count": 14, "updated_at": "2026-03-10T05:34:50Z" }, "user_id": "43028", "extension": "png", "folder_id": 10, "mime_type": "image/png", "created_at": "2026-03-10T04:37:27Z", "is_starred": false, "updated_at": "2026-03-10T04:37:27Z", "uploaded_at": "2026-03-10T04:37:27Z", "original_name": "Frame 1000003420 (1).png", "is_whatsapp_compatible": true, "whatsapp_compatibility_reason": "Ready for WhatsApp" }, { "id": 32, "url": "https://business.me-mate.net/getgabs-uploads/cdngallery/9f86443bd9f2ad28d1be4b62e8783e96720ec87a2ba86fcbeb5fc537483bf05b/files/5/MEL37P9ilmLodrQg.png", "hash": "b302a431204139c0572ab43b0d2bbc71297e8e1c21445d8daa786126de2d1cb1", "name": "Frame 1000003420.png", "path": "cdngallery/9f86443bd9f2ad28d1be4b62e8783e96720ec87a2ba86fcbeb5fc537483bf05b/files/5/MEL37P9ilmLodrQg.png", "size": 87963, "tags": [], "type": "image", "folder": { "id": 10, "name": "test2", "user_id": "43028", "is_system": false, "parent_id": 9, "created_at": "2026-03-09T13:10:07Z", "file_count": 14, "updated_at": "2026-03-10T05:34:50Z" }, "user_id": "43028", "extension": "png", "folder_id": 10, "mime_type": "image/png", "created_at": "2026-03-10T04:27:46Z", "is_starred": false, "updated_at": "2026-03-10T04:27:46Z", "uploaded_at": "2026-03-10T04:27:46Z", "original_name": "Frame 1000003420.png", "is_whatsapp_compatible": true, "whatsapp_compatibility_reason": "Ready for WhatsApp", "path_hash": "97eb4f8496332c912c3058d93d17fbdeba0a6be30911204e2bf888dcf2f7d2aa" }, { "id": 33, "url": "https://business.me-mate.net/getgabs-uploads/cdngallery/9f86443bd9f2ad28d1be4b62e8783e96720ec87a2ba86fcbeb5fc537483bf05b/files/5/Hj5UkEryJNCXtHwY.png", "hash": "3851267a8d31f9f92e03bc00d936bfbe42138b71a986312ca16b8230d38fdbda", "name": "Frame 1000003420 (1).png", "path": "cdngallery/9f86443bd9f2ad28d1be4b62e8783e96720ec87a2ba86fcbeb5fc537483bf05b/files/5/Hj5UkEryJNCXtHwY.png", "size": 40483, "tags": [], "type": "image", "folder": { "id": 10, "name": "test2", "user_id": "43028", "is_system": false, "parent_id": 9, "created_at": "2026-03-09T13:10:07Z", "file_count": 14, "updated_at": "2026-03-10T05:34:50Z" }, "user_id": "43028", "extension": "png", "folder_id": 10, "mime_type": "image/png", "created_at": "2026-03-10T04:27:46Z", "is_starred": false, "updated_at": "2026-03-10T04:27:46Z", "uploaded_at": "2026-03-10T04:27:46Z", "original_name": "Frame 1000003420 (1).png", "is_whatsapp_compatible": true, "whatsapp_compatibility_reason": "Ready for WhatsApp" }, { "id": 30, "url": "https://business.me-mate.net/getgabs-uploads/cdngallery/9f86443bd9f2ad28d1be4b62e8783e96720ec87a2ba86fcbeb5fc537483bf05b/files/5/Hj5UkEryJNCXtHwY.png", "hash": "3851267a8d31f9f92e03bc00d936bfbe42138b71a986312ca16b8230d38fdbda", "name": "Frame 1000003420 (1).png", "path": "cdngallery/9f86443bd9f2ad28d1be4b62e8783e96720ec87a2ba86fcbeb5fc537483bf05b/files/5/Hj5UkEryJNCXtHwY.png", "size": 40483, "tags": [], "type": "image", "folder": { "id": 10, "name": "test2", "user_id": "43028", "is_system": false, "parent_id": 9, "created_at": "2026-03-09T13:10:07Z", "file_count": 14, "updated_at": "2026-03-10T05:34:50Z" }, "user_id": "43028", "extension": "png", "folder_id": 10, "mime_type": "image/png", "created_at": "2026-03-09T13:27:18Z", "is_starred": false, "updated_at": "2026-03-09T13:27:18Z", "uploaded_at": "2026-03-09T13:27:18Z", "original_name": "Frame 1000003420 (1).png", "is_whatsapp_compatible": true, "whatsapp_compatibility_reason": "Ready for WhatsApp" }, { "id": 31, "url": "https://business.me-mate.net/getgabs-uploads/cdngallery/9f86443bd9f2ad28d1be4b62e8783e96720ec87a2ba86fcbeb5fc537483bf05b/files/5/ELJFFP6iLCVTEj0O.png", "hash": "30464dabbdff1a2575ddfed57ed49d205bb8156f793fa0fb4c5b80231de7a26c", "name": "ChatGPT Image Feb 20, 2026, 06_58_17 PM.png", "path": "cdngallery/9f86443bd9f2ad28d1be4b62e8783e96720ec87a2ba86fcbeb5fc537483bf05b/files/5/ELJFFP6iLCVTEj0O.png", "size": 186184, "tags": [], "type": "image", "folder": { "id": 10, "name": "test2", "user_id": "43028", "is_system": false, "parent_id": 9, "created_at": "2026-03-09T13:10:07Z", "file_count": 14, "updated_at": "2026-03-10T05:34:50Z" }, "user_id": "43028", "extension": "png", "folder_id": 10, "mime_type": "image/png", "created_at": "2026-03-09T13:27:18Z", "is_starred": false, "updated_at": "2026-03-09T13:27:18Z", "uploaded_at": "2026-03-09T13:27:18Z", "original_name": "ChatGPT Image Feb 20, 2026, 06_58_17 PM.png", "is_whatsapp_compatible": true, "whatsapp_compatibility_reason": "Ready for WhatsApp" }, { "id": 28, "url": "https://business.me-mate.net/getgabs-uploads/cdngallery/9f86443bd9f2ad28d1be4b62e8783e96720ec87a2ba86fcbeb5fc537483bf05b/files/5/Hj5UkEryJNCXtHwY.png", "hash": "3851267a8d31f9f92e03bc00d936bfbe42138b71a986312ca16b8230d38fdbda", "name": "Frame 1000003420 (1).png", "path": "cdngallery/9f86443bd9f2ad28d1be4b62e8783e96720ec87a2ba86fcbeb5fc537483bf05b/files/5/Hj5UkEryJNCXtHwY.png", "size": 40483, "tags": [], "type": "image", "folder": { "id": 10, "name": "test2", "user_id": "43028", "is_system": false, "parent_id": 9, "created_at": "2026-03-09T13:10:07Z", "file_count": 14, "updated_at": "2026-03-10T05:34:50Z" }, "user_id": "43028", "extension": "png", "folder_id": 10, "mime_type": "image/png", "created_at": "2026-03-09T13:24:04Z", "is_starred": false, "updated_at": "2026-03-09T13:24:04Z", "uploaded_at": "2026-03-09T13:24:04Z", "original_name": "Frame 1000003420 (1).png", "is_whatsapp_compatible": true, "whatsapp_compatibility_reason": "Ready for WhatsApp" }, { "id": 29, "url": "https://business.me-mate.net/getgabs-uploads/cdngallery/9f86443bd9f2ad28d1be4b62e8783e96720ec87a2ba86fcbeb5fc537483bf05b/files/5/ELJFFP6iLCVTEj0O.png", "hash": "30464dabbdff1a2575ddfed57ed49d205bb8156f793fa0fb4c5b80231de7a26c", "name": "ChatGPT Image Feb 20, 2026, 06_58_17 PM.png", "path": "cdngallery/9f86443bd9f2ad28d1be4b62e8783e96720ec87a2ba86fcbeb5fc537483bf05b/files/5/ELJFFP6iLCVTEj0O.png", "size": 186184, "tags": [], "type": "image", "folder": { "id": 10, "name": "test2", "user_id": "43028", "is_system": false, "parent_id": 9, "created_at": "2026-03-09T13:10:07Z", "file_count": 14, "updated_at": "2026-03-10T05:34:50Z" }, "user_id": "43028", "extension": "png", "folder_id": 10, "mime_type": "image/png", "created_at": "2026-03-09T13:24:04Z", "is_starred": false, "updated_at": "2026-03-09T13:24:04Z", "uploaded_at": "2026-03-09T13:24:04Z", "original_name": "ChatGPT Image Feb 20, 2026, 06_58_17 PM.png", "is_whatsapp_compatible": true, "whatsapp_compatibility_reason": "Ready for WhatsApp" }, { "id": 27, "url": "https://business.me-mate.net/getgabs-uploads/cdngallery/9f86443bd9f2ad28d1be4b62e8783e96720ec87a2ba86fcbeb5fc537483bf05b/files/10/EmEE3MVWjz2x6zWm.png", "hash": "66838bee0444b58195de34b1d5ab4d351eb6e5289ef6ca3f2001adc534869a32", "name": "login with whatsapp popup.png", "path": "cdngallery/9f86443bd9f2ad28d1be4b62e8783e96720ec87a2ba86fcbeb5fc537483bf05b/files/10/EmEE3MVWjz2x6zWm.png", "size": 82786, "tags": [], "type": "image", "folder": { "id": 10, "name": "test2", "user_id": "43028", "is_system": false, "parent_id": 9, "created_at": "2026-03-09T13:10:07Z", "file_count": 14, "updated_at": "2026-03-10T05:34:50Z" }, "user_id": "43028", "extension": "png", "folder_id": 10, "mime_type": "image/png", "created_at": "2026-03-09T13:10:22Z", "is_starred": false, "updated_at": "2026-03-09T13:10:22Z", "uploaded_at": "2026-03-09T13:10:22Z", "original_name": "login with whatsapp popup.png", "is_whatsapp_compatible": true, "whatsapp_compatibility_reason": "Ready for WhatsApp", "path_hash": "c634739e11e19324f807ce5010835ef7e841bdcf4cddfde3fc4a5399fb0a44a6" }, { "id": 25, "url": "https://business.me-mate.net/getgabs-uploads/cdngallery/9f86443bd9f2ad28d1be4b62e8783e96720ec87a2ba86fcbeb5fc537483bf05b/files/5/7gesLsd3UjlXAk35.png", "hash": "8337eed16484f8a356f2eb528c51b6833d80a52fc99b7017ad61607bb5a0abfc", "name": "ChatGPT Image Feb 20, 2026, 05_43_41 PM.png", "path": "cdngallery/9f86443bd9f2ad28d1be4b62e8783e96720ec87a2ba86fcbeb5fc537483bf05b/files/5/7gesLsd3UjlXAk35.png", "size": 229638, "tags": [], "type": "image", "folder": { "id": 10, "name": "test2", "user_id": "43028", "is_system": false, "parent_id": 9, "created_at": "2026-03-09T13:10:07Z", "file_count": 14, "updated_at": "2026-03-10T05:34:50Z" }, "user_id": "43028", "extension": "png", "folder_id": 10, "mime_type": "image/png", "created_at": "2026-03-09T12:52:17Z", "is_starred": false, "updated_at": "2026-03-09T12:52:17Z", "uploaded_at": "2026-03-09T12:52:17Z", "original_name": "ChatGPT Image Feb 20, 2026, 05_43_41 PM.png", "is_whatsapp_compatible": true, "whatsapp_compatibility_reason": "Ready for WhatsApp", "path_hash": "2dc1a538c18d434da5fc0ad7e7f5511272a611a56bc29525f543aa2c3cc83b1d" }, { "id": 24, "url": "https://business.me-mate.net/getgabs-uploads/cdngallery/9f86443bd9f2ad28d1be4b62e8783e96720ec87a2ba86fcbeb5fc537483bf05b/files/5/ELJFFP6iLCVTEj0O.png", "hash": "30464dabbdff1a2575ddfed57ed49d205bb8156f793fa0fb4c5b80231de7a26c", "name": "ChatGPT Image Feb 20, 2026, 06_58_17 PM.png", "path": "cdngallery/9f86443bd9f2ad28d1be4b62e8783e96720ec87a2ba86fcbeb5fc537483bf05b/files/5/ELJFFP6iLCVTEj0O.png", "size": 186184, "tags": [], "type": "image", "folder": { "id": 10, "name": "test2", "user_id": "43028", "is_system": false, "parent_id": 9, "created_at": "2026-03-09T13:10:07Z", "file_count": 14, "updated_at": "2026-03-10T05:34:50Z" }, "user_id": "43028", "extension": "png", "folder_id": 10, "mime_type": "image/png", "created_at": "2026-03-09T12:43:23Z", "is_starred": false, "updated_at": "2026-03-09T12:43:23Z", "uploaded_at": "2026-03-09T12:43:23Z", "original_name": "ChatGPT Image Feb 20, 2026, 06_58_17 PM.png", "is_whatsapp_compatible": true, "whatsapp_compatibility_reason": "Ready for WhatsApp", "path_hash": "2390af0a8678bc7282f50bac7f38d72056aa2d9f1f8cf4bc37442a76404ba1f5" }, { "id": 23, "url": "https://business.me-mate.net/getgabs-uploads/cdngallery/9f86443bd9f2ad28d1be4b62e8783e96720ec87a2ba86fcbeb5fc537483bf05b/files/5/Hj5UkEryJNCXtHwY.png", "hash": "3851267a8d31f9f92e03bc00d936bfbe42138b71a986312ca16b8230d38fdbda", "name": "Frame 1000003420 (1).png", "path": "cdngallery/9f86443bd9f2ad28d1be4b62e8783e96720ec87a2ba86fcbeb5fc537483bf05b/files/5/Hj5UkEryJNCXtHwY.png", "size": 40483, "tags": [], "type": "image", "folder": { "id": 10, "name": "test2", "user_id": "43028", "is_system": false, "parent_id": 9, "created_at": "2026-03-09T13:10:07Z", "file_count": 14, "updated_at": "2026-03-10T05:34:50Z" }, "user_id": "43028", "extension": "png", "folder_id": 10, "mime_type": "image/png", "created_at": "2026-03-09T12:43:22Z", "is_starred": false, "updated_at": "2026-03-09T12:43:22Z", "uploaded_at": "2026-03-09T12:43:22Z", "original_name": "Frame 1000003420 (1).png", "is_whatsapp_compatible": true, "whatsapp_compatibility_reason": "Ready for WhatsApp", "path_hash": "e8164ea9576399babc845067e797001524aa42c9108efeb077deeb0a3ab6cb4a" } ], "from": 1, "path": "https://business.me-mate.net/partners/wp-gallery/manage/files", "links": [ { "label": "« Previous", "active": false }, { "label": "1", "active": true, "url": "https://business.me-mate.net/partners/wp-gallery/manage/files?page=1", "page": 1 }, { "label": "Next »", "active": false } ], "total": 12, "per_page": 50, "last_page": 1, "current_page": 1, "last_page_url": "https://business.me-mate.net/partners/wp-gallery/manage/files?page=1", "first_page_url": "https://business.me-mate.net/partners/wp-gallery/manage/files?page=1" }, "success": true, "total_trash_count": 0, "total_starred_count": 0 } ``` **SDK Code** ```python import requests url = "https://business.me-mate.net/partners/wp-gallery/manage/files" querystring = {"folder_id":"{{folder_id}}","search":"Frame 1000003420.png"} response = requests.get(url, params=querystring) print(response.json()) ``` ```javascript const url = 'https://business.me-mate.net/partners/wp-gallery/manage/files?folder_id=%7B%7Bfolder_id%7D%7D&search=Frame+1000003420.png'; 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/files?folder_id=%7B%7Bfolder_id%7D%7D&search=Frame+1000003420.png" 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/files?folder_id=%7B%7Bfolder_id%7D%7D&search=Frame+1000003420.png") 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/files?folder_id=%7B%7Bfolder_id%7D%7D&search=Frame+1000003420.png") .asString(); ``` ```php request('GET', 'https://business.me-mate.net/partners/wp-gallery/manage/files?folder_id=%7B%7Bfolder_id%7D%7D&search=Frame+1000003420.png'); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://business.me-mate.net/partners/wp-gallery/manage/files?folder_id=%7B%7Bfolder_id%7D%7D&search=Frame+1000003420.png"); 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/files?folder_id=%7B%7Bfolder_id%7D%7D&search=Frame+1000003420.png")! 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() ```