---
title: "List what Patricia believes for this tenant"
method: GET
path: "/v1/memory/beliefs"
tags: ["memory-viewer"]
---

# List what Patricia believes for this tenant

`GET /v1/memory/beliefs`

## Request

- Base URL: `https://api.patricia.app` (the document declares no server; this is the origin it was published from)
- URL: `https://api.patricia.app/v1/memory/beliefs`
- Auth: HTTP bearer

Unified, source-labeled list of recallable memories, promoted lessons, and company facts.

## Query parameters

- `search` string, nullable: Case-insensitive substring filter.
- `kind` string, nullable: Filter to one of: memory | lesson | fact.
- `group` string, nullable: Filter to one provenance family.
- `limit` integer
- `offset` integer

## Headers

- `X-Tenant-Id` string, nullable

## Response `200`

Successful Response

- BeliefList: A page of beliefs plus stable corpus counts.
  - `items` BeliefItem[], required
    - `id` string, required: Opaque id: a memory/lesson UUID, or 'company:<field>' for a company fact.
    - `kind` string, required: One of 'memory' | 'lesson' | 'fact'.
    - `kind_code` string, nullable, required: Raw memory kind, or null for a company fact.
    - `kind_label` string, required: Friendly memory-kind label. Never a raw code.
    - `source` string, required: Provenance code (e.g. lesson_promoted, review, company_profile).
    - `source_label` string, required: Friendly provenance label, e.g. 'learned lesson'.
    - `group` string, required: Provenance family code.
    - `group_label` string, required: Friendly provenance-family label. Never a raw code.
    - `origin_title` string, nullable, required: Human name of the place the memory came from, when known.
    - `content` string, required
    - `created_at` string, date-time, nullable, required: When Patricia learned the item, or null when the source has no creation time.
    - `updated_at` string, date-time, nullable: The last write to the row. The Curator's 6-hourly decay sweep restamps this value. It is never a learn time and must never be labelled 'learned'.
    - `editable` boolean
    - `forgettable` boolean
  - `total` integer, required: True count of items matching the request filters.
  - `groups` BeliefGroup[], required: Non-empty family counts over the search-filtered corpus, ignoring kind and group filters.
    - `code` string, required
    - `label` string, required
    - `count` integer, required
  - `new_since_yesterday` integer, required: Search-filtered items learned during the last 24 hours, excluding company facts.

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden. Inspect response body `code` for the specific reason (for example: PERMISSION_DENIED, EMAIL_NOT_VERIFIED, TENANT_ACCESS_REQUIRED, ROLE_UNRESOLVED)
- `404`: Not found
- `422`: Validation error

---

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