--- title: "Get all folders" url: "https://docs.signnow.com/docs/folder/operations/get-all-folders" type: "endpoint" section: "folder" slug: "folder/operations/get-all-folders" method: "GET" path: "/user/folder" operation_id: "get-all-folders" authorization: "bearer" --- # Get all folders `GET /user/folder` 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}`. ## Authorization bearer ## Query Parameters | Name | Type | Required | Description | |------|------|----------|-------------| | `filters` | string | No | Filter to apply to the document list. Possible values: `signing-status`, `documents-created`, `documents-updated`. Set the filter value in `filter-values`. | | `filter-values` | string | No | Value for the filter set in `filters`. For `signing-status`: `signed`, `pending`, `waiting-for-me`, `waiting-for-others`, `unsent`. For `documents-created` and `documents-updated`: a Unix timestamp; documents created or updated from that time are returned. Date filters do not apply to templates. | | `sortby` | string | No | Field to sort documents by. Possible values: `created`, `updated`, `recently_used`. `recently_used` sorts templates by the date the last invite was sent and applies to `Templates` folders. | | `order` | string | No | Sort order. Can be used only with `sortby`. Possible values: `desc`, `asc`. Default: `desc`. | | `limit` | integer | No | Maximum number of documents to return. Max: `100`. Larger values are reduced to `100`. | | `offset` | integer | No | Number of documents to skip before the returned page starts. | | `subfolder-data` | string | No | Whether to include subfolders in the response. Possible values: `1`, `0`. Must be used with `include_documents_subfolders`. | | `include_documents_subfolders` | string | No | Whether to include subfolders in the response. Possible values: `1`, `0`. Must be used with `subfolder-data`. | | `with_team_documents` | string | No | Whether to include `Team Documents` folders. Possible values: `true`, `false`. | | `only_favorites` | string | No | Whether to return only favorite documents and document groups. Possible values: `true`, `false`. Default: `false`. | | `entity_type` | string | No | Entities counted in `document_count` and `template_count`. Possible values: `document-all` (default): only documents or only templates, depending on the folder type. `all`: all entity types in the folder. `document`: documents that are not in a document group; `Documents`, `Archive`, and `Trash Bin` folders only. `document-group`: documents in document groups; `Documents`, `Archive`, and `Trash Bin` folders only. `template`: templates; `Templates` and `Trash Bin` folders only. `dgt`: document group templates; `Templates` and `Trash Bin` folders only. | ## Responses ### 200 * Success * With document group invite where user is the owner * With document group invite where user is the signer * With viewer field invites **Example** (`Success`) ```json { "id": "38697ad01ad8dad98e5f81439775940c6f40ba0f", "name": "Root Folder", "shared": false, "created": "1532531633", "folders": [ { "id": "251dd280b288182ad4c6493726b6a8f213ecf812", "name": "Templates", "shared": false, "created": "1532531633", "user_id": "89cc3b125c73c80d68d9fdf672426a4273ba7c8a", "sub_folders": [], "folder_count": "0", "document_count": "0", "template_count": "11" }, { "id": "3bfdd05b3be61241fa743f11e9f3c03539a46238", "name": "Team Templates", "shared": true, "created": "1557915422", "team_id": "c38fa601feb71c335e70e50006fc1fca9e8adf5e", "user_id": "89cc3b125c73c80d68d9fdf672426a4273ba7c8a", "team_name": "Sample team", "team_type": "VIEWABLE", "sub_folders": [], "folder_count": "0", "document_count": "0", "template_count": "3" }, { "id": "5426d2e8af6beaee4da6154c1d4037e92788464e", "name": "Team Templates", "shared": true, "created": "1543922139", "team_id": "96f4d8b767cbc1badd95bb82d7ccb15701e28287", "user_id": "89cc3b125c73c80d68d9fdf672426a4273ba7c8a", "team_name": "My team", "team_type": "VIEWABLE", "sub_folders": [], "folder_count": "0", "document_count": "0", "template_count": "1" }, { "id": "8320475dd00a86f18311ad72b4b5cde67ed1f7da", "name": "Archive", "shared": false, "created": "1532531633", "user_id": "89cc3b125c73c80d68d9fdf672426a4273ba7c8a", "sub_folders": [], "folder_count": "0", "document_count": "21", "template_count": 0 }, { "id": "9ea63029fb7b8b3007cb871b9fcef554f1db52e5", "name": "Trash Bin", "shared": false, "created": "1567466970", "user_id": "89cc3b125c73c80d68d9fdf672426a4273ba7c8a", "sub_folders": [], "folder_count": "0", "document_count": "0", "template_count": 0 }, { "id": "c8ad123a9ca674f49070e59dbe32806d300aa680", "name": "Documents", "shared": false, "created": "1532531633", "user_id": "89cc3b125c73c80d68d9fdf672426a4273ba7c8a", "sub_folders": [], "folder_count": "0", "document_count": "74", "template_count": 0 } ], "user_id": "89cc3b125c73c80d68d9fdf672426a4273ba7c8a", "documents": [], "parent_id": null, "system_folder": false, "total_documents": 0 } ``` **Example** (`With viewer field invites`) ```json { "id": "a9c50c4fd12fc61a1d9f0364b04a981ce717c783", "name": "Documents", "shared": false, "created": "1616586778", "folders": [], "user_id": "30fa20445ecc569f1b6269e01369c709bf3f9398", "documents": [ { "id": "cd1364085149afc82f79eb28c21080190994a2cc", "owner": "document-owner@email.com", "created": 1616586981, "invites": [ { "email": "signer@email.com", "order": "1", "action": "sign", "status": "fulfilled", "document_id": "06f32e82688ed868dc34465c14c41e642c282f28", "document_name": "Performance review", "authentication": null, "expiration_time": null }, { "email": "manager@email.com", "order": "2", "action": "sign", "status": "fulfilled", "document_id": "06f32e82688ed868dc34465c14c41e642c282f28", "document_name": "Performance review", "authentication": null, "expiration_time": null }, { "order": "2", "action": "view", "status": "pending", "document_id": "06f32e82688ed868dc34465c14c41e642c282f28", "email_group": { "id": "e7b69891e5e699736212fe2c79f2d3dda68c7b57", "name": "HR team" }, "document_name": "Performance review", "authentication": null, "expiration_time": 1618210633 } ], "updated": 1616586981, "user_id": "30fa20445ecc569f1b6269e01369c709bf3f9398", "documents": [ { "id": "d2873eaea0fa1b09ec2df19bfe718ec50c896426", "name": "sample", "roles": [ "Signer 1", "Manager" ] } ], "invite_id": "ee9b80704287ec855a5b58e8d14b79fbdde8fdbc", "document_group_name": "Document Group 24-3-2021", "viewer_field_invites": [ { "id": "ee9b80704287ec855a5b58e8d14b79fbdde8fdbc", "email_group": { "id": "e7b69891e5e699736212fe2c79f2d3dda68c7b57", "name": "HR team" } } ] } ], "parent_id": "667ac6283ec9d72a48dc858962564a6f1bcb38f6", "system_folder": true, "total_documents": 1 } ``` **Example** (`With document group where user is a signer`) ```json { "id": "a9c50c4fd12fc61a1d9f0364b04a981ce717c783", "name": "Documents", "shared": false, "created": "1616586778", "folders": [], "user_id": "30fa20445ecc569f1b6269e01369c709bf3f9398", "documents": [ { "id": "cd1364085149afc82f79eb28c21080190994a2cc", "owner": "owner-email@email.com", "created": 1616586981, "updated": 1616586981, "user_id": "30fa20445ecc569f1b6269e01369c709bf3f9398", "documents": [ { "id": "d2873eaea0fa1b09ec2df19bfe718ec50c896426", "name": "sample", "roles": [ "Signer 1", "Signer 2" ], "field_invites": [ { "id": "e491809e26baf1aec83a9654adc5fadc27a04301", "email_group": { "id": "f666c0a96c527faad470b7da6f262a0c4c8967f1", "name": "Contact group" } }, { "id": "2b6d0a2d03fde6fa0ecd9a13e0d2b9c605c3036d", "email_group": { "id": "c24c9e85479bbbf17d755699510fa94114e65347", "name": "Contact group" } } ] } ], "invite_id": "ee9b80704287ec855a5b58e8d14b79fbdde8fdbc", "document_group_name": "Document Group 24-3-2021" } ], "parent_id": "667ac6283ec9d72a48dc858962564a6f1bcb38f6", "system_folder": true, "total_documents": 1 } ``` **Example** (`With document group invite where user is the owner`) ```json { "id": "a9c50c4fd12fc61a1d9f0364b04a981ce717c783", "name": "Documents", "shared": false, "created": "1616586778", "folders": [], "user_id": "30fa20445ecc569f1b6269e01369c709bf3f9398", "documents": [ { "id": "cd1364085149afc82f79eb28c21080190994a2cc", "owner": "document-owner@email.com", "created": 1616586981, "invites": [ { "email": "signer@email.com", "order": "1", "action": "sign", "status": "fulfilled", "document_id": "06f32e82688ed868dc34465c14c41e642c282f28", "document_name": "Performance review", "authentication": null, "expiration_time": null }, { "email": "manager@email.com", "order": "2", "action": "sign", "status": "fulfilled", "document_id": "06f32e82688ed868dc34465c14c41e642c282f28", "document_name": "Performance review", "authentication": null, "expiration_time": null }, { "order": "2", "action": "view", "status": "pending", "document_id": "06f32e82688ed868dc34465c14c41e642c282f28", "email_group": { "id": "e7b69891e5e699736212fe2c79f2d3dda68c7b57", "name": "HR team" }, "document_name": "Performance review", "authentication": null, "expiration_time": 1618210633 } ], "updated": 1616586981, "user_id": "30fa20445ecc569f1b6269e01369c709bf3f9398", "documents": [ { "id": "d2873eaea0fa1b09ec2df19bfe718ec50c896426", "name": "sample", "roles": [ "Signer 1", "Manager" ] } ], "invite_id": "ee9b80704287ec855a5b58e8d14b79fbdde8fdbc", "document_group_name": "Document Group 24-3-2021" } ], "parent_id": "667ac6283ec9d72a48dc858962564a6f1bcb38f6", "system_folder": true, "total_documents": 1 } ``` ### 400 * Get info about specific folder which doesn't belong to the user. **Example** (`Get info about specific folder which doesn't belong to the user`) ```json { "errors": [ { "code": 65611, "message": "resource does not exist" } ] } ``` ## Code Examples > Replace `$SIGNNOW_ACCESS_TOKEN` and any `{placeholder}` values before running. ### cURL ```bash curl -X GET \ "https://api.signnow.com/user/folder" \ -H "Authorization: Bearer $SIGNNOW_ACCESS_TOKEN" ``` --- *Full reference: https://docs.signnow.com/docs/folder/operations/get-all-folders*