List organization shares

GET

/api/v1/shares

GET

/api/v1/shares

1 curl -G https://https//https/api/v1/shares \
2      -H "Authorization: Bearer <token>" \
3      -d type=file \
4      -d status=active

1 {
2   "shares": [
3     {
4       "id": "201aa640-50fd-....",
5       "type": "file",
6       "file_name": "encrypted-eu-stg/encrypted/UhS2g0angBI5T......epub",
7       "created_at": "2026-04-28T23:46:10.000Z",
8       "expires_at": "2026-05-05T21:46:10.000Z",
9       "file_size_bytes": 1964665,
10       "created_by_user_id": "user_...."
11     },
12     {
13       "id": "681da863-a551-....",
14       "type": "file",
15       "file_name": "encrypted-eu-stg/encrypted/Yt8dtyS2nWZ8ue......epub",
16       "created_at": "2026-04-28T23:42:36.000Z",
17       "expires_at": "2026-05-05T21:42:36.000Z",
18       "file_size_bytes": 1964665,
19       "created_by_user_id": "user_...."
20     },
21     {
22       "id": "4c04938f-71de-....",
23       "type": "file",
24       "file_name": "encrypted-eu-stg/encrypted/2HKgu9m2jgZna......zip",
25       "created_at": "2026-04-28T23:29:55.000Z",
26       "expires_at": "2026-04-30T21:29:55.000Z",
27       "file_size_bytes": 1964665,
28       "created_by_user_id": "user_...."
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 headers

X-Middleware-Rewritestring

Access-Control-Allow-Originstring

Access-Control-Allow-Headersstring

Access-Control-Allow-Methodsstring

Response

shareslist of objects

paginationobject

Errors

401

Unauthorized Error

403

Forbidden Error