---
title: "Memory usage and tier limits"
method: GET
path: "/v1/memory/stats"
tags: ["memory"]
---

# Memory usage and tier limits

`GET /v1/memory/stats`

## Request

- Base URL: `https://api.lithtrix.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.lithtrix.ai/v1/memory/stats`
- Auth: none declared

Read-only snapshot: monthly memory ops, storage bytes, limits, and over_limit. Does not mutate stored memories.

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- MemoryStatsResponse: Aggregated memory usage for dashboard / agent introspection.
  - `status` 'success'
  - `tier` string, required
  - `ops_this_month` integer, required
  - `ops_remaining` integer, nullable
  - `ops_limit` integer, nullable
  - `storage_bytes` integer, required
  - `storage_limit_bytes` integer, required
  - `over_limit` boolean, required

## Other responses

- `422`: Validation Error

---

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