List Organization Secure Vault Folder Items

GET

/organizations/secure-vault/folders/:folder_id/items

GET

/rest/organizations/secure-vault/folders/:folder_id/items

$ curl -G https://api.letsdeel.com/rest/organizations/secure-vault/folders/c106a26a-21bb-5538-8bf2-57095d1976c1/items \
>      -H "Authorization: Bearer <token>" \
>      -d limit=20 \
>      -d cursor=eyJpZCI6MTIzfQ \
>      -d search=contracts

1 {
2   "data": [
3     {
4       "id": "c106a26a-21bb-5538-8bf2-57095d1976c1",
5       "name": "Contracts",
6       "type": "FOLDER",
7       "folder_id": "f2d1b0c4-8a3e-4c11-9f77-2b6c5e1a90d3",
8       "item_type": "CUSTOM_FOLDER",
9       "created_at": "2026-08-05T12:00:00Z",
10       "description": "Signed customer contracts",
11       "uploaded_by": {
12         "name": "John Doe"
13       },
14       "content_type": "application/pdf",
15       "is_sub_folder": false,
16       "parent_folder_id": "f2d1b0c4-8a3e-4c11-9f77-2b6c5e1a90d3"
17     }
18   ],
19   "has_more": true,
20   "next_cursor": "eyJpZCI6MTIzfQ==",
21   "total_count": 124
22 }

Lists the files and sub-folders contained in a specific Organization Secure Vault folder. Use this endpoint to browse or paginate the contents of a single folder; to list items at the vault root instead, use the root-listing endpoint.

Token scopes: organizations:read

Authentication

AuthorizationBearer

Authentication

The Deel API uses bearer tokens to authenticate requests. All API calls must be made over HTTPS — calls over plain HTTP or without authentication will fail.

$ curl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \
>   -H 'Authorization: Bearer YOUR-TOKEN-HERE'

Learn more about authentication

## Authentication The Deel API uses bearer tokens to authenticate requests. All API calls must be made over HTTPS — calls over plain HTTP or without authentication will fail. ```curl curl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \ -H 'Authorization: Bearer YOUR-TOKEN-HERE' ``` [Learn more about authentication](/api/authentication)

AuthorizationBearer

Standard OAuth2 security scheme based on https://swagger.io/docs/specification/authentication/

Path parameters

folder_idstringRequiredformat: "uuid"

Public UUID of the folder.

Query parameters

limitintegerOptional1-100Defaults to 20

Maximum number of results to return per page.

cursorstringOptional<=2048 characters

Pagination cursor returned by a previous response.

searchstringOptional<=255 characters

Free-text search on folder and file names.

Response

Folder items returned successfully.

datalist of objects

Folders and files for this page.

has_moreboolean

Whether another page of results is available.

next_cursorstring or null

Cursor for the next page. Null when there are no more pages.

total_countinteger>=0

Total number of matching records.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error

$	curl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \
>	-H 'Authorization: Bearer YOUR-TOKEN-HERE'