> ## Documentation Index
> Fetch the complete documentation index at: https://collabase.ch/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Collabase documentation. Interface labels are quoted in English, as they appear in the product.
> Features marked Enterprise need the Collabase Enterprise Edition licence.

# List CRM notes

> List the CRM notes the token owner may read, of one record or of all records, newest first with a cursor.

Returns the notes the token owner may read. A private note of someone else, a note shared with other
people only, and the notes of a type the roles do not allow never appear, whatever the token's scope.
A page is always full: its size and cursor do not tell how many notes were hidden.

> [!NOTE]
>
> Scope `crm:read`.

## Query parameters

**recordId** `string`

Only the notes on this record. A record the token owner may not read answers `404`.

**cursor** `string`

The `nextCursor` of the previous page.

**limit** `number` (default: 50)

1 to 100; more is cut down to 100.

## Response

**data** `object` *required*

**properties**

**items** `array` *required*

Each note has `id`, `title`, `body` (editor blocks), `visibility` (`PRIVATE`, `SHARED`, `ALL`), `authorId`, `authorName`, `contentUpdatedAt`, `createdAt` and `targets`.

**nextCursor** `string | null` *required*

`null` on the last page.

**canCreate** `boolean` *required*

Whether the token owner may write notes.

```bash cURL theme={"dark"}
curl "https://your-collabase.ch/api/v1/crm/notes?recordId=cm3rec0001&limit=25" \
  -H "Authorization: Bearer cb_xYz123ABCD..."
```

```json 200 theme={"dark"}
{ "data": { "items": [], "nextCursor": null, "canCreate": true } }
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.