---
title: "Get a knowledge item"
description: "One item with its text."
url: "https://openemail.uk/docs/api/knowledge/get"
area: "API"
category: "Mailbox"
---

# Get a knowledge item

One item with its text.

`GET /knowledge/{id}`

## GET /knowledge/{id}

One item with its text.

## Example

Needs `knowledge:read`. `body` is the text of a note. `preview` is the first 20,000 characters read from a file or a page, null until it has been read, and `previewTruncated` says whether the text goes on.

**curl**

```
curl "$OE/knowledge/kb_8c1f4a2b9d7e3f60a5c7b21d" -H "$AUTH"
```

**Response**

```
{
  "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",
  "body": "Refunds are paid within 14 days of the return reaching our warehouse.",
  "preview": "Refunds are paid within 14 days of the return reaching our warehouse.",
  "previewTruncated": false
}
```

> An unknown id, and an item at a level the key cannot see, answer 404 `knowledge_not_found`.

## Reference

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