---
updatedAt: 2025-11-12T02:57:47.000Z
agentTools:
  projectIndex: https://docs.sevenbridges.com/llms.txt
---

# List folder contents

> 📘 If you are using Seven Bridges Platform EU, please use the following endpoint: `https://eu-api.sbgenomics.com/v2/files/{folder_id}/list`

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "seven-bridges-platform",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://api.sbgenomics.com/v2"
    }
  ],
  "security": [
    {}
  ],
  "paths": {
    "/files/{folder_id}/list": {
      "get": {
        "summary": "List folder contents",
        "description": "",
        "operationId": "list-folder-contents",
        "parameters": [
          {
            "name": "X-SBG-Auth-Token",
            "in": "header",
            "description": "Your Seven Bridges Platform [authentication token](https://docs.sevenbridges.com/docs/get-your-authentication-token). For security reasons, token will not be automatically populated in the generated code sample. Please replace `<your-token-here>` with your token before executing this call.",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "The maximum number of collection items to return for a single request. Minimum value is 1. The maximum value is 100 and the default value is 50. This is a pagination-specific attribute.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 50
            }
          },
          {
            "name": "offset",
            "in": "query",
            "description": "The zero-based starting index in the entire collection of the first item to return. The default value is 0. This is a pagination-specific attribute.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 0
            }
          },
          {
            "name": "folder_id",
            "in": "path",
            "description": "ID of the folder whose contents you want to list. Use the call to [list files and folders in a project](list-files-primary-method) to get the ID.",
            "schema": {
              "type": "string"
            },
            "required": true
          }
        ],
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n  \"href\": \"https://api.sbgenomics.com/v2/files/567890abc9b0307bc0414164/list?offset=0&limit=5\",\n  \"items\": [\n    {\n      \"href\": \"https://api.sbgenomics.com/v2/files/567890abc1e5339df0414123\",\n      \"id\": \"567890abc1e5339df0414123\",\n      \"name\": \"folder-name-1\",\n      \"project\": \"rfranklin/my-project\",\n      \"parent\": \"567890abc9b0307bc0414164\",\n      \"type\": \"FOLDER\"\n    },\n    {\n      \"href\": \"https://api.sbgenomics.com/v2/files/567890abc3d8130ea4047731\",\n      \"id\": \"567890abc3d8130ea4047731\",\n      \"name\": \"file-name-1\",\n      \"project\": \"rfranklin/my-project\",\n      \"parent\": \"567890abc9b0307bc0414164\",\n      \"type\": \"FILE\"\n    },"
                  }
                }
              }
            }
          }
        },
        "deprecated": false,
        "x-readme": {
          "code-samples": [
            {
              "language": "python",
              "code": "from sevenbridges import Api\n\napi = Api(url='https://api.sbgenomics.com/v2',\n          token='1e43fEXampLEa5523dfd14exAMPle3e5')\n\nfolder = api.files.get(id='567890abc9b0307bc0414164')\n\n# send GET request to SB API\nfiles = folder.list_files()\n\nfor file in files:\n    print(file.name, file.type)",
              "name": "Python"
            }
          ],
          "samples-languages": [
            "python"
          ]
        }
      }
    }
  },
  "x-readme": {
    "headers": [
      {
        "key": "X-SBG-Auth-Token",
        "value": "<your-token-here>"
      }
    ],
    "explorer-enabled": false,
    "proxy-enabled": false
  },
  "x-readme-fauxas": true
}
```