---
title: "Get CAG cache statistics"
method: GET
path: "/pots/{pot_id}/cag/stats"
tags: ["cag", "cag"]
---

# Get CAG cache statistics

`GET /pots/{pot_id}/cag/stats`

Get statistics for the CAG cache of a POT.

Returns:
- Cache size (constitution, high-certainty, total)
- Hit/miss rates
- Timing information (initialization, last refresh)

Useful for monitoring cache performance and debugging.

## Path parameters

- `pot_id` string, required — POT identifier (UUID or slug)

## Response `200`

Cache statistics

- CAGStatsResponse — Response for GET /cag/stats endpoint.
  - `pot_id` string, required — POT identifier
  - `cache_stats` CacheStatsData, required — Cache statistics.
    - `constitution_size` integer, required — Number of Constitution facts in cache
    - `certainty_size` integer, required — Number of high-certainty facts in cache
    - `total_size` integer, required — Total cached facts
    - `threshold` number, required — POT Index threshold for high-certainty cache
    - `max_certainty_size` integer, required — Maximum facts in high-certainty cache
  - `hit_stats` HitStatsData, required — Cache hit/miss statistics.
    - `total_searches` integer, required — Total search operations
    - `cache_hits` integer, required — Searches that found results
    - `cache_misses` integer, required — Searches with no results
    - `hit_rate` number, required — Cache hit rate [0-1]
  - `timing` TimingData, required — Cache timing information.
    - `initialized_at` string, nullable — When cache was initialized (ISO 8601)
    - `last_refresh` string, nullable — Last cache refresh (ISO 8601)

## Other responses

- `404` — POT not found or cache not initialized
- `422` — Validation Error

---

[API](https://skmtc.dev/scipot/apis/scipot-core-api.md) · [All operations](https://skmtc.dev/scipot/apis/scipot-core-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/scipot/scipot-core-api/revisions/e8712e9ffeae/schema)