For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
DiscordPlatform
DocumentationIntegrationsAPI referenceSDKsChangelog
DocumentationIntegrationsAPI referenceSDKsChangelog
  • API Reference
      • GETList cached responses
      • POSTList cached responses with filters
      • DELBulk delete cached responses
      • GETRetrieve a cached response
      • GETGet cache summary
      • POSTGet filtered cache summary
      • DELDelete all cached responses
  • Reference
    • Filters API Reference
LogoLogo
DiscordPlatform
API ReferenceCaches

List cached responses with filters

POST
https://api.respan.ai/api/caches/
POST
/api/caches/
$curl -X POST https://api.respan.ai/api/caches/ \
>     -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." \
>     -H "Content-Type: application/json" \
>     -d '{}'
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}

List cached responses using POST-for-filtering. This endpoint returns the same response shape as GET /api/caches/ and currently requires dashboard JWT authentication.

Was this page helpful?
Previous

Bulk delete cached responses

Next
Built with

Headers

AuthorizationstringRequired

Bearer JWT token for dashboard-authenticated cache management endpoints.

Query parameters

pageintegerOptional>=1
Page number.
page_sizeintegerOptional1-1000
Number of results to return per page. Maximum 1000.

Request

This endpoint expects an object.
filtersobjectOptional
Filter criteria using the standard Respan filter format.

Response

Filtered cached responses plus aggregate cache savings.
summaryobject
dataobject

Errors

400
Bad Request Error
401
Unauthorized Error