---
title: "Retrieve a cached response"
method: GET
path: "/api/caches/{cache_key}/"
tags: ["caches"]
---

# Retrieve a cached response

`GET /api/caches/{cache_key}/`

Retrieve a cached response by its organization-scoped cache key. API-key responses omit internal numeric IDs.

## Path parameters

- `cache_key` string, required

## Headers

- `Authorization` string, required

## Response `200`

Cached response details.

- CachesApiCachesRetrieveResponse200
  - `id` integer — Internal numeric ID. Present only for dashboard-JWT responses.
  - `cache_key` string, required — Organization-scoped public cache key.
  - `prompt_content` string, required — Prompt text extracted from the cached request.
  - `response_content` string, required — Response text extracted from the cached response.
  - `request_content` string — Stored request text preview. The current backend serializer truncates this field to roughly the first 100 characters.
  - `prompt_messages` ApiCachesCacheKeyGetResponsesContentApplicationJsonSchemaPromptMessagesItems[] — Original prompt message array stored with the cache entry.
  - `full_response` ApiCachesCacheKeyGetResponsesContentApplicationJsonSchemaFullResponse — Full cached provider response object.
  - `hit_count` integer, required — Live cache hit count enriched from ClickHouse.
  - `response_time` number, double — Stored response time for the cached entry, in seconds.
  - `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

- `401` — Unauthorized - Missing or invalid authentication
- `404` — Not Found

---

[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)