> ## Documentation Index
> Fetch the complete documentation index at: https://docs.repdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List folders

> # Description

List folders of the current user.

# Response

## 200 OK

```json
[
    {
        "createdAt": "string",
        "id": "string",
        "title": "string",
        "totalProjectsCount": "number"
    }
]
```

where: 

- `createdAt`: Date of creation of the folder in the format `YYYY-MM-DDTHH:mm:ss.SSSZ`.
- `id`: Id of the folder.
- `title`: Title of the folder.
- `totalProjectsCount`: Number of projects inside the folder.

## 400 Bad Request

> Folder is not found.

## 401 Unauthorized

> The user doesn't have permissions.

## 500 Internal Server Error

> Error occurred while processing the request.

# Description

List folders of the current user.

# Response

## 200 OK

```json theme={null}
[
    {
        "createdAt": "string",
        "id": "string",
        "title": "string",
        "totalProjectsCount": "number"
    }
]
```

where:

* `createdAt`: Date of creation of the folder in the format `YYYY-MM-DDTHH:mm:ss.SSSZ`.
* `id`: Id of the folder.
* `title`: Title of the folder.
* `totalProjectsCount`: Number of projects inside the folder.

## 400 Bad Request

> Folder is not found.

## 401 Unauthorized

> The user doesn't have permissions.

## 500 Internal Server Error

> Error occurred while processing the request.

##### Query Parameters

| Parameter    | Description | Required | Example |
| ------------ | ----------- | -------- | ------- |
| `page`       | —           | No       | —       |
| `limit`      | —           | No       | —       |
| `skip`       | —           | No       | —       |
| `orderField` | —           | No       | —       |
| `order`      | —           | No       | —       |


## OpenAPI

````yaml GET /projects-api/v1/folders/{folderId}/subfolders
openapi: 3.0.3
info:
  title: SightX API
  version: 1.0.0
  description: >-
    SightX REST API documentation. Most responses are JSON; some export
    endpoints return files. API access is a paid add-on — contact
    sales@sightx.io for details.
servers:
  - url: https://auth.admin.sightx.io
    description: Authentication (Production)
  - url: https://auth.staging-admin.sightx.io
    description: Authentication (Staging)
security:
  - AuthorizationHeader: []
paths:
  /projects-api/v1/folders/{folderId}/subfolders:
    get:
      summary: List folders
      description: >-
        # Description


        List folders of the current user.


        # Response


        ## 200 OK


        ```json

        [
            {
                "createdAt": "string",
                "id": "string",
                "title": "string",
                "totalProjectsCount": "number"
            }
        ]

        ```


        where: 


        - `createdAt`: Date of creation of the folder in the format
        `YYYY-MM-DDTHH:mm:ss.SSSZ`.

        - `id`: Id of the folder.

        - `title`: Title of the folder.

        - `totalProjectsCount`: Number of projects inside the folder.


        ## 400 Bad Request


        > Folder is not found.


        ## 401 Unauthorized


        > The user doesn't have permissions.


        ## 500 Internal Server Error


        > Error occurred while processing the request.
      operationId: list-folders-get-projects-api-v1-folders-folderid-subfolders
      parameters:
        - name: Authorization
          in: header
          required: true
          description: Authorization token
          schema:
            type: string
        - name: page
          in: query
          required: false
          schema:
            type: string
        - name: limit
          in: query
          required: false
          schema:
            type: string
        - name: skip
          in: query
          required: false
          schema:
            type: string
        - name: orderField
          in: query
          required: false
          schema:
            type: string
        - name: order
          in: query
          required: false
          schema:
            type: string
      responses:
        '200':
          description: List folders
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
              example:
                - title: Shared
                  createdAt: '2020-12-22T21:13:23.711Z'
                  id: 5fe26173bacbc129197fa003
                  totalProjectsCount: 0
                - title: Tests
                  createdAt: '2020-09-21T15:46:27.271Z'
                  id: 5f68cad3204754005cad52c1
                  totalProjectsCount: 0
                - title: Tickets
                  createdAt: '2020-11-23T18:23:32.010Z'
                  id: 5fbbfe24b2822e00ae84952e
                  totalProjectsCount: 0
        '400':
          description: Bad request
        '401':
          description: Unauthorized
        '500':
          description: Internal server error
      servers:
        - url: https://project.sightx.io
components:
  securitySchemes:
    AuthorizationHeader:
      type: apiKey
      in: header
      name: Authorization
      description: Access token obtained from the m2m-token endpoint.

````