> ## 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 lists

> List the CRM lists the token owner may open: their own, shared ones and those shared with their groups.

Returns the lists the token owner may open, by name, a page at a time. Another person's private list
never appears.

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

## Query parameters

**cursor** `string`

The `nextCursor` of the previous page.

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

1 to 200; more is cut down to 200.

## Response

**data** `object` *required*

**properties**

**items** `array` *required*

Each list has `id`, `name`, `typeKey`, `kind` (`STATIC` or `DYNAMIC`), `cql`, `visibility` (`PRIVATE` or `SHARED`), `ownerId`, `canEdit` and `entryCount` (`null` for a dynamic list).

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

`null` on the last page.

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

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


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