---
title: "List cached responses with filters"
method: POST
path: "/api/caches/"
tags: ["caches"]
---

# List cached responses with filters

`POST /api/caches/`

List cached responses using POST-for-filtering. API-key responses expose public cache keys; dashboard JWT responses may include internal numeric identifiers.

## Query parameters

- `page` integer
- `page_size` integer

## Headers

- `Authorization` string, required

## Request body

- object
  - `filters` ApiCachesPostRequestBodyContentApplicationJsonSchemaFilters — Filter criteria using the standard Respan filter format.

## Response `200`

Filtered cached responses plus aggregate cache savings.

- CachesFilterCachedResponsesResponse200
  - `summary` ApiCachesPostResponsesContentApplicationJsonSchemaSummary, required
    - `total_cost` number, double, required — Estimated total cost saved by cache hits in the current organization.
    - `total_hit_count` integer, required — Total number of cache hits recorded for the current organization.
    - `total_tokens` integer, required — Estimated total tokens saved by cache hits.
    - `total_time` number, double, required — Estimated total latency saved in seconds.
  - `data` ApiCachesPostResponsesContentApplicationJsonSchemaData, required
    - `count` integer, required — Number of cache entries returned on this page.
    - `next` string, nullable — URL for the next page, if any.
    - `previous` string, nullable — URL for the previous page, if any.
    - `current_filters` ApiCachesPostResponsesContentApplicationJsonSchemaDataCurrentFilters — Normalized filter state returned by the paginator when filters are applied.
    - `results` ApiCachesPostResponsesContentApplicationJsonSchemaDataResultsItems[], required — Cached response entries for the current page.
      - `id` integer — Internal numeric ID. Present only for dashboard-JWT responses.
      - `cache_key` string, required — Unique cache key for this cached response.
      - `prompt_content` string, required — Prompt text extracted from the cached request.
      - `response_content` string, required — Response text extracted from the cached response.
      - `hit_count` integer, required — Live cache hit count enriched from ClickHouse. Defaults to 0 if unavailable.
      - `timestamp` string, date-time, required — When the cache entry was created.
      - `updated_at` string, date-time, required — When the cache entry was last updated.
      - `expiry_date` string, date-time, nullable — When the cache entry expires. `null` means no expiry date is set.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized - Missing or invalid authentication

---

[API](https://skmtc.net/keywordsai/apis/api-reference.md) · [All operations](https://skmtc.net/keywordsai/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/keywordsai/api-reference/revisions/4e064cf81dae/schema)