List Organization Shares | Konfidant

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

{
  "shares": [
    {
      "type": "file",
      "file_size_bytes": 1964720,
      "created_at": "2026-10-03T09:46:10.000Z",
      "expires_at": "2026-10-10T09:46:10.000Z",
      "accessed_at": null,
      "created_by": "foo@bar.com"
    },
    {
      "type": "text",
      "file_size_bytes": null,
      "created_at": "2026-10-03T09:42:36.000Z",
      "expires_at": "2026-10-03T17:42:36.000Z",
      "accessed_at": "2026-10-03T10:01:12.000Z",
      "created_by": "foo@bar.com"
    }
  ],
  "pagination": {
    "total": 2,
    "limit": 50,
    "offset": 0,
    "has_more": false
  }
}

Lists the organization’s shares, newest first. The order is stable, so paging with limit and offset never repeats or skips a share. Only metadata is returned: no content, file names or keys (Konfidant does not have them). Only shares created while verified burn was enabled are recorded.

Authentication

AuthorizationBearer

Konfidant API key (kf_live_... or kf_test_...), created by an organization admin in the dashboard.

Query parameters

typeenumOptional

Filter by share type

Allowed values:

statusenumOptional

Filter by status: not yet opened (active) or opened (accessed)

Allowed values:

limitintegerOptional1-100Defaults to 50

offsetintegerOptional>=0Defaults to 0

Number of shares to skip

Response

shareslist of objects

paginationobject

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

429

Too Many Requests Error