List organization shares

GET

https://www.konfidant.app/api/v1/shares

GET

/api/v1/shares

1 const url = 'https://www.konfidant.app/api/v1/shares?type=file&status=active';
2 const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
3 
4 try {
5   const response = await fetch(url, options);
6   const data = await response.json();
7   console.log(data);
8 } catch (error) {
9   console.error(error);
10 }

1 {
2   "shares": [
3     {
4       "type": "file",
5       "file_name": "UhS2g0angBI5T.epub",
6       "file_size_bytes": 1964665,
7       "created_at": "2026-04-28T23:46:10.000Z",
8       "expires_at": "2026-05-05T21:46:10.000Z",
9       "accessed_at": null,
10       "created_by": "[email protected]"
11     },
12     {
13       "type": "file",
14       "file_name": "Yt8dtyS2nWZ8ue.epub",
15       "file_size_bytes": 1964665,
16       "created_at": "2026-04-28T23:42:36.000Z",
17       "expires_at": "2026-05-05T21:42:36.000Z",
18       "accessed_at": null,
19       "created_by": "[email protected]"
20     },
21     {
22       "type": "file",
23       "file_name": "2HKgu9m2jgZna.zip",
24       "file_size_bytes": 1964665,
25       "created_at": "2026-04-28T23:29:55.000Z",
26       "expires_at": "2026-04-30T21:29:55.000Z",
27       "accessed_at": null,
28       "created_by": "[email protected]"
29     }
30   ],
31   "pagination": {
32     "limit": 50,
33     "total": 3,
34     "offset": 0,
35     "has_more": false
36   }
37 }

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

typestringOptional

file or text

statusstringOptional

active or accessed

limitstringOptional

offsetstringOptional

Response

shareslist of objects

paginationobject

Errors

401

Unauthorized Error

403

Forbidden Error