---
title: "Get Cache Overview"
method: GET
path: "/ai_caching/overview"
tags: ["AI_SERVICES"]
---

# Get Cache Overview

`GET /ai_caching/overview`

Prompt-cache KPIs, a per-model breakdown and time series.

## Query parameters

- `start_date` string, date-time, required
- `end_date` string, date-time
- `instance_id` string
- `service_type` 'cortex_analyst' | 'cortex_document_processing' | 'cortex_fine_tuning' | 'cortex_functions' | 'cortex_search' | 'cortex_code_cli' | 'cortex_code_snowsight' | 'cortex_agent' | 'snowflake_intelligence' | 'cortex_code_desktop' | 'reader_ai_services' | 'reader_ai_inference' | 'reader_cortex_code_snowsight' | 'ai_inference' | 'ai_services_other'
- `navigationSource` string, nullable

## Headers

- `x-tenant` string, required

## Response `200`

Successful Response

- CacheOverviewResponse
  - `kpis` CacheKpis, required
    - `uncached_input_tokens` CacheKpi, required — One headline number with its previous-period comparison. ``previous`` and ``delta_pct`` are ``None`` when the earlier window holds no data — a delta against zero is noise, not a trend.
      - `value` number, required
      - `previous` number, nullable
      - `delta_pct` number, nullable
    - `cache_read_tokens` CacheKpi, required — One headline number with its previous-period comparison. ``previous`` and ``delta_pct`` are ``None`` when the earlier window holds no data — a delta against zero is noise, not a trend.
      - `value` number, required
      - `previous` number, nullable
      - `delta_pct` number, nullable
    - `cache_read_ratio` CacheKpi, required — One headline number with its previous-period comparison. ``previous`` and ``delta_pct`` are ``None`` when the earlier window holds no data — a delta against zero is noise, not a trend.
      - `value` number, required
      - `previous` number, nullable
      - `delta_pct` number, nullable
  - `models` CacheModelRow[]
    - `model` string, required
    - `service_type` string, required
    - `requests` integer, required
    - `input_tokens` integer, required
    - `output_tokens` integer, required
    - `cache_read_tokens` integer, required
    - `cache_write_tokens` integer, required
    - `read_ratio` number, required
    - `write_amortization` number, nullable
  - `series` CachePoint[]
    - `bucket` string, date-time, required
    - `model` string, required
    - `input_tokens` integer, required
    - `cache_read_tokens` integer, required
    - `cache_write_tokens` integer, required
    - `read_ratio` number, required
    - `write_amortization` number, nullable
  - `bucket` string, required
  - `covered_services` string[]

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/myaltimate/apis/fastapi.md) · [All operations](https://skmtc.net/myaltimate/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/myaltimate/fastapi/versions/aab3fe5c9f05/schema)