---
title: "List knowledge items"
description: "The items in the knowledge base, newest first, a page at a time."
url: "https://openemail.uk/docs/api/knowledge/list"
area: "API"
category: "Mailbox"
---

# List knowledge items

The items in the knowledge base, newest first, a page at a time.

`GET /knowledge`

## GET /knowledge

The items in the knowledge base, newest first, a page at a time.

## Example

Needs `knowledge:read`. Every filter is optional: `scope` keeps one level, `level` one kind of level (`workspace`, `domain` or `address`), `kind` notes, files or links, `status` one status, `pinned` the pinned notes, and `q` matches words in the title, the file name or the link. `limit` goes up to 100 and defaults to 50, and `cursor` takes the previous page’s `nextCursor`.

**curl**

```
curl "$OE/knowledge?level=domain&limit=20" -H "$AUTH"
```

**Response**

```
{
  "object": "list",
  "data": [{
      "object": "knowledge_item",
      "id": "kb_8c1f4a2b9d7e3f60a5c7b21d",
      "kind": "note",
      "scope": "@acme.com",
      "level": "domain",
      "title": "Refunds",
      "url": null,
      "fileName": null,
      "mimeType": null,
      "sizeBytes": null,
      "pinned": true,
      "status": "ready",
      "failure": null,
      "chunks": 1,
      "chars": 71,
      "origin": "api",
      "createdBy": "usr_5f2a9c71",
      "createdAt": "2026-10-08T09:12:44.000Z",
      "updatedAt": "2026-10-08T09:12:44.000Z",
      "indexedAt": "2026-10-08T09:12:45.000Z"
    }],
  "hasMore": false,
  "nextCursor": null
}
```

> A key or an app limited to particular addresses sees the whole-workspace items and the items at its addresses and at their domains. A level it cannot see lists nothing.

> A cursor this list did not hand out is a 400 `invalid_cursor`.

## Reference

- [`GET /knowledge`](https://openemail.uk/docs/api/reference/knowledge#get-knowledge): full reference