---
title: "List knowledge notes"
method: GET
path: "/api/knowledge"
tags: ["Knowledge"]
---

# List knowledge notes

`GET /api/knowledge`

## Request

- Base URL: `https://api.historis.app`
- URL: `https://api.historis.app/api/knowledge`
- Auth: HTTP bearer

Newest-updated first. Tag and person filters are AND (a note must carry every slug / link to every id). The three time windows are inclusive and independent: since/until on creation, updatedSince/updatedUntil on last modification, eventSince/eventUntil on the occurred_at of a linked event -- the date the note is about. Each bound accepts YYYY-MM-DD or a full ISO 8601 instant carrying Z or a numeric offset.

## Query parameters

- `query` string
- `status` 'active' | 'archived' | 'all'
- `tags` string
- `personIds` string
- `since` string, date-time
- `until` string, date-time
- `updatedSince` string, date-time
- `updatedUntil` string, date-time
- `eventSince` string, date-time
- `eventUntil` string, date-time
- `limit` integer
- `offset` integer

## Response `200`

Notes and the exact total

- object

## Other responses

- `400`: Request failed schema validation
- `401`: Missing or invalid credentials
- `429`: Rate limit exceeded for the caller's identity/plan
- `500`: Internal server error

---

[API](https://skmtc.dev/historis/apis/historis-api.md) · [All operations](https://skmtc.dev/historis/apis/historis-api/llms.txt) · [OpenAPI document](https://skmtc.dev/historis/apis/historis-api/revisions/fa382546b63e?raw)