List cached responses

curl https://api.respan.ai/api/caches/ \
     -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

{
  "summary": {
    "total_cost": 12.5,
    "total_hit_count": 1042,
    "total_tokens": 250000,
    "total_time": 3600.5
  },
  "data": {
    "count": 1,
    "results": [
      {
        "id": 123,
        "cache_key": "cached_response_550e8400-e29b-41d4_abc123def456",
        "prompt_content": "What is the capital of France?",
        "response_content": "The capital of France is Paris.",
        "hit_count": 42,
        "timestamp": "2026-04-10T12:00:00Z",
        "updated_at": "2026-04-10T12:00:00Z",
        "expiry_date": "2026-05-10T12:00:00Z"
      }
    ],
    "next": null,
    "previous": null,
    "current_filters": {}
  }
}

List cached responses with pagination and live hit count enrichment. Returns organization-level cache savings in summary and paginated cache entries in data. This cache management endpoint currently requires dashboard JWT authentication.

Query parameters

pageintegerOptional>=1

Page number.

page_sizeintegerOptional1-1000

Number of results to return per page. Maximum 1000.

Response

Cached responses plus aggregate cache savings.

summaryobject

dataobject

Errors

401

Unauthorized Error

List cached responses

List cached responses

Headers

Query parameters

Response

Errors

Headers

Query parameters

Response

Errors

$	curl https://api.respan.ai/api/caches/ \
>	-H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

1	{
2	"summary": {
3	"total_cost": 12.5,
4	"total_hit_count": 1042,
5	"total_tokens": 250000,
6	"total_time": 3600.5
7	},
8	"data": {
9	"count": 1,
10	"results": [
11	{
12	"id": 123,
13	"cache_key": "cached_response_550e8400-e29b-41d4_abc123def456",
14	"prompt_content": "What is the capital of France?",
15	"response_content": "The capital of France is Paris.",
16	"hit_count": 42,
17	"timestamp": "2026-04-10T12:00:00Z",
18	"updated_at": "2026-04-10T12:00:00Z",
19	"expiry_date": "2026-05-10T12:00:00Z"
20	}
21	],
22	"next": null,
23	"previous": null,
24	"current_filters": {}
25	}
26	}