---
title: "Get all folders"
method: GET
path: "/user/folder"
---

# Get all folders

`GET /user/folder`

## Request

- Base URL: `https://api.signnow.com`
- URL: `https://api.signnow.com/user/folder`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/signnow/apis/signnow-api/docs/user/folder/get.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint allows API users to get the root folder of the user and its top-level folders, including the system folders (`Documents`, `Archive`, `Templates`, `Trash Bin`) and team folders.

**Notes**

* The same operation is also available at `GET /folder`.
* `document_count` and `template_count` depend on `entity_type`. By default (`document-all`), a folder counts only documents or only templates, depending on the folder type.
* To get the contents of a specific folder, call `GET /folder/{folder_id}`.

## Response `200`

* Success
* With document group invite where user is the owner
* With document group invite where user is the signer
* With viewer field invites

- object
  - `id` string: ID of the root folder.
  - `name` string: Name of the root folder. Always `Root`.
  - `shared` boolean: Whether the folder is shared.
  - `created` string: Unix timestamp of when the root folder was created, as a string.
  - `folders` object[]: Top-level folders of the user, including system folders and team folders.
    - `id` string: ID of the folder.
    - `name` string: Name of the folder, for example `Documents`, `Templates`, or `Trash Bin`.
    - `shared` boolean: Whether the folder is shared.
    - `created` string: Unix timestamp of when the folder was created, as a string.
    - `team_id` string: ID of the team. Team folders only.
    - `user_id` string: ID of the folder owner.
    - `team_name` string: Name of the team. Team folders only.
    - `team_type` string: Access type of the team folder, for example `VIEWABLE`. Team folders only.
    - `folder_count` string: Number of subfolders in the folder, as a string.
    - `document_count` string: Number of documents in the folder, as a string. Which entities are counted depends on `entity_type`.
    - `template_count` string: Number of templates in the folder, as a string. Which entities are counted depends on `entity_type`.
  - `user_id` string: ID of the user.
  - `documents` object[]: Documents directly in the root folder. Usually empty.
  - `parent_id` string: ID of the parent folder. Always `null` for the root folder.
  - `system_folder` boolean: Whether the folder is a system folder. Always `true` for the root folder.
  - `total_documents` integer: Number of documents directly in the root folder.

## Other responses

- `400`: * Get info about specific folder which doesn't belong to the user.

---

[API](https://skmtc.dev/signnow/apis/signnow-api.md) - [All operations](https://skmtc.dev/signnow/apis/signnow-api/llms.txt) - [OpenAPI document](https://skmtc.dev/signnow/apis/signnow-api/revisions/1c9c30a6142b?raw)