# List knowledge-base collections and entries

Operation ID: `patient.listKnowledge`

Return the assistant's knowledge-base collections and entry summaries, optionally filtered by `collection`. No authentication is required.

## Public method

`listKnowledge`

Signature: `patient.listKnowledge(query)`

Return type: `Promise<ListKnowledgeResponse>`

## Authentication

Classification: **PUBLIC**

## Prerequisites

None documented.

## HTTP

`GET /assistant/knowledge`

## Path parameters

None.

## Query parameters

| Name | Type | Required | Format | Allowed values | Default | Nullable | Description |
|---|---|---:|---|---|---|---:|---|
| `collection` | `string` | No |  |  |  | No |  |

## Body parameters

None.

Request model: None.

## Request example

None declared in canonical OpenAPI.

## Success responses

| Status | Shape | Content type | Description |
|---|---|---|---|
| `200` | [`ListKnowledgeResponse`](../models/ListKnowledgeResponse.md) | application/json | Assistant knowledge catalog |

## Success response examples

### 200

```json
{
  "collections": [
    {
      "id": "ppe",
      "name": "PPE & Safety"
    }
  ],
  "entries": [
    {
      "collection": "ppe",
      "id": "kb_004",
      "tags": [
        "ppe"
      ],
      "title": "Standard PPE for field screening"
    }
  ],
  "total": 3
}
```

## Common errors

None declared in canonical OpenAPI.

## Error examples

None declared in canonical OpenAPI.

## NodeJS / TypeScript implementation

```ts
import { HCSDK } from "@healthcloudai/hc-sdk";
```

```ts
const query = {
  "collection": "<COLLECTION>"
};

const result = await patient.listKnowledge(query);
```

## cURL

```bash
curl -X GET \
  'https://dev-api-patient.health.cloud/assistant/knowledge?collection=%3CCOLLECTION%3E'
```

## Notes

None.

## Prepared Test Console scenario

No canonical scenario is currently associated.

## Real response

No approved real integration response is currently published. Unapproved candidates are never rendered as examples.