List File(s)

Lists files and directories in your Filerobot store.

GET /list

API Permissions

OBJECTS_LIST

Query parameters

Parameter Type Default Description
dir string [Optional] / Specifies folder to list files from. Case sensitive.
Example: /path/to/folder
limit number [Optional] 1000 Specifies the maximum amount of files and directories to return [1 - 4000]
offset number [Optional] 0 Specifies the offset of files and directories to display
mime mimeType [Optional] None Returns only files from specified mimeType
search string [Optional] None Returns files and directories with filename, tags or description matching the search string

The /list API roughly matches the Unix ls command. If you want to list files across folders, then use the /search API that imitates the Unix find command

Try it out

Request

Copy-paste the cURL request in your Terminal or click on the API Explorer tab to see the API in action.

host: 'https://api.filerobot.com' path: /fusqadtm/list method: GET parameters: {} variables: {} headers: X-Filerobot-Key: 19692813e7364ef8ad6a6504d50a12ca body: "" theme: clouds-midnight curlAPIKey: "" axiosTimeout: 35000 maxContentLength: 150000 render: curl_tab: true

Response

{
    "status": "success",
    "files": [
        {
            "uuid": "a6ef3fa9-c9c2-5495-b530-e982b3c50000",
            "name": "car.jpeg",
            "size": 152756,
            "size_pretty": "149.18 KB",
            "type": "image/jpeg",
            "meta": {
                "img_h": 667,
                "img_w": 1000,
                "img_type": "JPEG"
            },
            "properties": {
                "lang": "en",
                "tags": [
                    "Land vehicle",
                    "Vehicle",
                    "Car",
                    "Mercedes-benz sls amg",
                    "Performance car",
                    "Sports car",
                    "Automotive design",
                    "Motor vehicle",
                    "Personal luxury car",
                    "Mercedes-benz"
                ],
                "search": "Land vehicle Vehicle Car Mercedes-benz sls amg Performance car Sports car Automotive design Motor vehicle Personal luxury car Mercedes-benz",
                "description": ""
            },
            "url_public": "https://store.filerobot.com/fusqadtm/car.jpeg?v=7139c2",
            "url_permalink": "https://api.filerobot.com/fusqadtm/v1/get/_/a6ef3fa9-c9c2-5495-b530-e982b3c50000/car.jpeg?v=7139c2",
            "sha1": "7139c2fce5a3ba35ae7ea6b3ecee51dc49793158",
            "created_at": "2019-06-10T17:24:39Z",
            "modified_at": "2019-06-10T19:13:18Z",
            "dir_uuid": "7e766397-b258-53b1-933a-a338503e7ebe",
            "dir_name": "/",
            "container": "airstore_094dd930_ccd3_4945_a051_a55b484678a8",
            "public_link": "https://store.filerobot.com/fusqadtm/car.jpeg"
        },
        {
            "uuid": "07cb7fcb-e5ba-500a-8ae9-e5a6fcf50000",
            "name": "property.jpeg",
            "size": 82652,
            "size_pretty": "80.71 KB",
            "type": "image/jpeg",
            "meta": {
                "img_h": 667,
                "img_w": 1000,
                "img_type": "JPEG"
            },
            "properties": {},
            "url_public": "https://store.filerobot.com/fusqadtm/property.jpeg?v=f7217f",
            "url_permalink": "https://api.filerobot.com/fusqadtm/v1/get/_/07cb7fcb-e5ba-500a-8ae9-e5a6fcf50000/property.jpeg?v=f7217f",
            "sha1": "f7217f65dadd6add9cdcdd7b5410b737063c2b6a",
            "created_at": "2019-06-10T17:24:39Z",
            "modified_at": "2019-06-10T17:24:42Z",
            "dir_uuid": "7e766397-b258-53b1-933a-a338503e7ebe",
            "dir_name": "/",
            "container": "airstore_094dd930_ccd3_4945_a051_a55b484678a8",
            "public_link": "https://store.filerobot.com/fusqadtm/property.jpeg"
        }
    ],
    "directories": [
        {
            "uuid": "b0526062-e072-5c5f-93ee-79e4131ed20d",
            "path": "/chair-360",
            "name": "chair-360",
            "properties": {},
            "updated_at": "2019-05-22T08:58:07Z",
            "count_files_recursive": 36,
            "count_files_direct": 36,
            "total_size_recursive": 1966549,
            "total_size_recursive_pretty": "1.88 MB",
            "public_icon": "http://scaleflex.cloudimg.io/crop/300x300/x/http://www.airstore.io/assets/dir.png"
        },
        {
            "uuid": "c3a19e90-6b98-526d-a130-de39d3321190",
            "path": "/hotels",
            "name": "hotels",
            "properties": {},
            "updated_at": "2019-06-01T18:52:09Z",
            "count_files_recursive": 0,
            "count_files_direct": 0,
            "total_size_recursive": 0,
            "total_size_recursive_pretty": "0 B",
            "public_icon": "http://scaleflex.cloudimg.io/crop/300x300/x/http://www.airstore.io/assets/dir.png"
        },
        {
            "uuid": "746feaa6-4faa-5e9e-8caa-9efc988db9b8",
            "path": "/image-editor",
            "name": "image-editor",
            "properties": {},
            "updated_at": "2019-05-19T17:39:02Z",
            "count_files_recursive": 5,
            "count_files_direct": 5,
            "total_size_recursive": 1299630,
            "total_size_recursive_pretty": "1.24 MB",
            "public_icon": "http://scaleflex.cloudimg.io/crop/300x300/x/http://www.airstore.io/assets/dir.png"
        },
        {
            "uuid": "de43c020-a4b4-54fc-9412-c5e73c7458e5",
            "path": "/people",
            "name": "people",
            "properties": {},
            "updated_at": "2019-06-12T12:57:31Z",
            "count_files_recursive": 8,
            "count_files_direct": 8,
            "total_size_recursive": 17999771,
            "total_size_recursive_pretty": "17.17 MB",
            "public_icon": "http://scaleflex.cloudimg.io/crop/300x300/x/http://www.airstore.io/assets/dir.png"
        }
    ],
    "info": {
        "total_files_count": 2,
        "total_files_method": "COUNT_EXACT",
        "atom": "atom009",
        "response_time": 0.036
    }
}