---
title: "Get statistics for memory bank"
method: GET
path: "/v1/default/banks/{bank_id}/stats"
tags: ["Banks"]
---

# Get statistics for memory bank

`GET /v1/default/banks/{bank_id}/stats`

## Request

- Base URL: `https://hindsight.vectorize.io` (the document declares no server; this is the origin it was published from)
- URL: `https://hindsight.vectorize.io/v1/default/banks/{bank_id}/stats`
- Auth: none declared
- TypeScript: <https://skmtc.dev/vectorize/apis/hindsight-http-api/docs/v1/default/banks/:bank_id/stats/get.ts> (a function with typed inputs; its response is checked against the schema)

Get statistics about nodes and links for a specific agent

## Path parameters

- `bank_id` string, required

## Query parameters

- `refresh` boolean: Force a fresh recompute, bypassing the cached value (and refreshing the cache).

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- BankStatsResponse: Response model for bank statistics endpoint.
  - `bank_id` string, required
  - `total_nodes` integer, required
  - `total_links` integer, required
  - `total_documents` integer, required
  - `nodes_by_fact_type` object, required
  - `links_by_link_type` object, required
  - `links_by_fact_type` object, required
  - `links_breakdown` object, required
  - `pending_operations` integer, required
  - `failed_operations` integer, required
  - `operations_by_status` object: Async operations grouped by status (pending, processing, completed, failed, cancelled).
  - `last_consolidated_at` string, nullable: When consolidation last ran (ISO format)
  - `last_memory_write_at` string, nullable: When a memory was last written in this bank — stored, edited, or consolidated (ISO format). Null if the bank has no memories. A mental model whose `last_memory_seen_at` is at or after this is up to date whatever its tags; an older one may need a refresh, which only the single mental-model read can confirm.
  - `pending_consolidation` integer: Number of source memories (world/experience) still queued for consolidation into observations. Excludes memories whose consolidation permanently failed — those are counted only in failed_consolidation — so this drains to 0 when the consolidator catches up.
  - `failed_consolidation` integer: Number of source memories (world/experience) whose consolidation permanently failed and can be retried via the consolidation recovery endpoint.
  - `total_observations` integer: Total number of observations
  - `paused_mental_models` integer: Number of mental models whose last refresh failed, so the automatic triggers (`refresh_after_consolidation`, `refresh_cron`, `full_refresh_cron`) skip them until an explicit refresh succeeds. Their content stops updating, so alert on this being above 0. Each model's `last_refresh_failed_at` says which ones, and its history says why.

## Other responses

- `404`: The bank does not exist.
- `422`: Validation Error

## Changes

- **2026-11-07** `45e711cd0897`: 1 info
  - added the optional property `paused_mental_models` to the response with the `200` status
- **2026-10-04** `4fda98b75f63`: 1 warning, 3 info
  - removed the optional property `detail/items/url` from the response with the `422` status
  - added the new optional `query` request parameter `refresh`
  - added the non-success response with the status `404`
  - added the optional property `last_memory_write_at` to the response with the `200` status
- **2026-05-15** `0d08f271b9db`: 5 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status
  - added the optional property `detail/items/url` to the response with the `422` status
  - added the optional property `failed_consolidation` to the response with the `200` status
  - …1 more

[Operation history](https://skmtc.dev/vectorize/apis/hindsight-http-api/changes/v1/default/banks/:bank_id/stats/get.md)

---

[API](https://skmtc.dev/vectorize/apis/hindsight-http-api.md) - [All operations](https://skmtc.dev/vectorize/apis/hindsight-http-api/llms.txt) - [OpenAPI document](https://skmtc.dev/vectorize/apis/hindsight-http-api/revisions/45e711cd0897?raw)