Get folder by id
GET {{url}}/folder/{{folder_id}}
Returns all details of a specific folder including an array of all documents in that folder.
You can adjust the response produced by this endpoint using the following query parameters:
filters=signing-status&filter-values - allows to show documents with specific status
allowed values: signed, pending, waiting-for-me, waiting-for-others
filters=documents-created&filter-values - shows documents that were created started from specific date (note: this filter is not applicable for Templates)
allowed values: Unix timestamp
filters=documents-updated&filter-values - shows documents that were updated started from specific date (note: this filter is not applicable for Templates)
allowed values: Unix timestamp
sortby=created&order - sorts documents by creation date in descending or ascending order
allowed values: desc, asc
sortby=updated&order - sorts documents by update date
allowed values: desc, asc
limit - displays specified number of documents; Max limit is 100. It means that if value of limit
parameter exceeds 100, response is automatically limited to 100 documents.
allowed values: integer
offset - displays documents from specified position
allowed values: integer
subfolder-data - defines whether sub-folders of the given folder are displayed in the response.
allowed values: 1, 0 (i.e. subfolder-data=1)
withteamdocuments - allows to display Team Documents
folders.
allowed values: true, false (i.e. withteamdocuments=true)
excludedocumentsrelations - allows to display short list of document info and increases maximum limit from 100 to 500 documents per page.
allowed values: true, false (i.e. excludedocumentsrelations=false)
The short list of document info is:
{
"id": " ",
"user_id": " ",
"document_name": " ",
"page_count": " ",
"created": " ",
"updated": " ",
"original_filename": " "
}
includedocumentssubfolders - allows to hide sub-folders and display all documents from those sub-folders in the parent folder. Parameter works only for Documents
and Template
folder and their children. Default value - true
allowed values: true, false
excludedocumentsrelations - when this param is true, for documents in folder won’t include relations such as fields, signatures, etc, only the main info will be displayed.
allowed values: true, false
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
Authorization | string |