---
title: "Get Cache Status"
method: GET
path: "/data/projects/{projectId}/cache/{cacheId}/status"
tags: ["Data -- Cache"]
---

# Get Cache Status

`GET /data/projects/{projectId}/cache/{cacheId}/status`

## Request

- Base URL: `https://partner.peaka.studio/api/v1`
- URL: `https://partner.peaka.studio/api/v1/data/projects/{projectId}/cache/{cacheId}/status`
- Auth: HTTP bearer

Returns the current status of a specific cache, including execution details for both the last incremental sync and the last full refresh.

The top-level `status` field is computed from the most recent execution across both sync types:
- `NOT_INITIALIZED`: No sync has ever been executed for this cache.
- `RUNNING`: At least one sync (incremental or full refresh) is currently in progress.
- `COMPLETED`: The most recent sync completed successfully.
- `FAILED`: The most recent sync failed. Check the `error` field in the relevant execution info for details.
- `CANCELLED`: The most recent sync was cancelled via a cancel endpoint.

Each execution info object (`lastIncrementalCacheExecution`, `lastFullRefreshCacheExecution`) contains:
- `id`: Unique execution identifier.
- `status`: Execution-specific status (RUNNING, COMPLETED, FAILED, CANCELLED).
- `progress`: Real-time progress with record counts (cached, inserted, updated, deleted).
- `error`: Error details if the execution failed.
- `createdAt`, `updatedAt`, `finishedAt`: Timestamps tracking execution lifecycle.

Use `excludeLogs=true` to omit the `cacheActionLogs` array for a lighter response, especially when polling for status during an active sync.

## Path parameters

- `projectId` string, required
- `cacheId` string, required

## Query parameters

- `excludeLogs` boolean

## Response `200`

Cache status retrieved successfully.

## Other responses

- `404`: Cache not found for the given cacheId.

---

[API](https://skmtc.dev/peaka/apis/peaka-gateway-api.md) · [All operations](https://skmtc.dev/peaka/apis/peaka-gateway-api/llms.txt) · [OpenAPI document](https://skmtc.dev/peaka/apis/peaka-gateway-api/revisions/e68b033a22d5?raw)