--- title: "List all files" url: "https://docs.unified.to/storage/file/List_all_files" description: "API reference for List all files. Launch multiple pre-built File integrations today with zero maintenance — all through a single API." generated_at: "2026-05-20T23:12:32.541Z" --- # List all files GET/storage/{connection\_id}/file ## Parameters **limit**number default=100 **offset**number default=0 **updated\_gte**date Return only results whose updated date is equal or greater to this value (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format) **sort** enum name updated\_at created\_at **order** enum asc desc **query**string Query string to search. eg. email address or name **parent\_id**string The parent ID to filter by **reference**string The referenced entity ID to filter by (e.g. linked accounting record for storage\_file) **type**string The type to filter by **expand**boolean Whether to flatten grouped or recurring items into individual entries. **fulltext**string The fulltext to filter by **fields**string array id created\_at updated\_at name description parent\_id user\_id size type mime\_type permissions download\_url hash data version web\_url references raw Fields to return **raw**string Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters: foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar **connection\_id**string required ID of the connection ## Returns [StorageFile](/storage/file/model)array **id**string **created\_at**date (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format) **updated\_at**date (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format) **name**string **description**string **parent\_id**string **user\_id**string (reference to HrisEmployee) **size**number **type** enum Valid values: "FILE" "FOLDER" **mime\_type**string **permissions** array **download\_url**string This link expires after 1 hour. When you need to retrieve the contents of a file, call the "Retrieve a file" endpoint again to get a new download\_url. **hash**string **data**string base64 encoded file contents used to create/update only **version**string **web\_url**string **references** array **raw**any ## Code Samples ### Node.js SDK ``` import { UnifiedTo } from '@unified-api/typescript-sdk'; const sdk = new UnifiedTo({ security: { jwt: '', }, }); const connectionId = '5de520f96e439b002043d8dc'; const results = await sdk.storage.listStorageFiles({ connectionId, limit: 50, offset: 0, updated_gte: '2026-05-20T23:10:44.916Z', sort: 'updated_at', order: 'asc', query: '', parent_id: '', reference: '', type: '', expand: false, fulltext: '', fields: '', raw: '', }); ``` ### Node.js (axios) ``` const options = { method: 'GET', url: 'https://api.unified.to/storage/5de520f96e439b002043d8dc/file', headers: { authorization: 'bearer .....' }, params: { limit: 50, offset: 0, updated_gte: '2026-05-20T23:10:44.916Z', sort: 'updated_at', order: 'asc', query: '', parent_id: '', reference: '', type: '', expand: false, fulltext: '', fields: '', raw: '', } }; const results = await axios.request(options); ``` ### Java ``` AsyncHttpClient client = new DefaultAsyncHttpClient(); client.prepare("GET", "https://api.unified.to/storage/5de520f96e439b002043d8dc/file?limit=50&offset=0&updated_gte=2026-05-20T23:10:44.916Z&sort=updated_at&order=asc&query=&parent_id=&reference=&type=&expand=false&fulltext=&fields=&raw=") .setHeader("accept", "application/json") .setHeader("authorization", ".....") .execute() .toCompletableFuture() .thenAccept(System.out::println) .join(); client.close(); ``` ### Go ``` import ( "fmt" "net/http" "io/ioutil" ) url := `https://api.unified.to/storage/5de520f96e439b002043d8dc/file?limit=50&offset=0&updated_gte=2026-05-20T23:10:44.916Z&sort=updated_at&order=asc&query=&parent_id=&reference=&type=&expand=false&fulltext=&fields=&raw= req, _ := http.NewRequest("GET", url, nil) req.Header.Add("accept", "application/json") req.Header.Add("authorization", ".....") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := ioutil.ReadAll(res.Body) ``` ### Python ``` import requests url = "https://api.unified.to/storage/5de520f96e439b002043d8dc/file?limit=50&offset=0&updated_gte=2026-05-20T23:10:44.916Z&sort=updated_at&order=asc&query=&parent_id=&reference=&type=&expand=false&fulltext=&fields=&raw=" headers = { "accept": "application/json", "authorization": "....." } response = requests.get(url, headers=headers) ``` ### PHP ``` $curl = curl_init(); curl_setopt_array($curl, [ CURLOPT_URL => "https://api.unified.to/storage/5de520f96e439b002043d8dc/file?limit=50&offset=0&updated_gte=2026-05-20T23:10:44.916Z&sort=updated_at&order=asc&query=&parent_id=&reference=&type=&expand=false&fulltext=&fields=&raw=", CURLOPT_RETURNTRANSFER => true, CURLOPT_ENCODING => "", CURLOPT_MAXREDIRS => 10, CURLOPT_TIMEOUT => 30, CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1, CURLOPT_CUSTOMREQUEST => "GET", CURLOPT_HTTPHEADER => [ "accept: application/json", "authorization: ....." ], ]); ``` ### Ruby ``` require 'uri' require 'net/http' require 'openssl' url = URI("https://api.unified.to/storage/5de520f96e439b002043d8dc/file?limit=50&offset=0&updated_gte=2026-05-20T23:10:44.916Z&sort=updated_at&order=asc&query=&parent_id=&reference=&type=&expand=false&fulltext=&fields=&raw=") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Get.new(url) request["accept"] = 'application/json' request["authorization"] = '....' response = http.request(request) puts response.read_body ``` ### cURL ``` curl --request GET \ --url 'https://api.unified.to/storage/5de520f96e439b002043d8dc/file?limit=50&offset=0&updated_gte=2026-05-20T23:10:44.916Z&sort=updated_at&order=asc&query=&parent_id=&reference=&type=&expand=false&fulltext=&fields=&raw=' \ --header 'accept: application/json' \ --header 'authorization: .....' ```