---
title: "Return status of a cache"
method: GET
path: "/http/caches/{httpCacheZoneName}"
tags: ["HTTP Caches", "Method GET"]
---

# Return status of a cache

`GET /http/caches/{httpCacheZoneName}`

Returns status of a particular cache.

## Query parameters

- `fields` string

## Response `200`

Success

- NginxHTTPCache
  - `size` integer — The current size of the cache.
  - `max_size` integer — The limit on the maximum size of the cache specified in the configuration.
  - `cold` boolean — A boolean value indicating whether the “cache loader” process is still loading data from disk into the cache.
  - `hit` object
    - `responses` integer — The total number of <a href="https://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_cache_valid">valid</a> responses read from the cache.
    - `bytes` integer — The total number of bytes read from the cache.
  - `stale` object
    - `responses` integer — The total number of expired responses read from the cache (see <a href="https://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_cache_use_stale">proxy_cache_use_stale</a> and other “<code>*_cache_use_stale</code>” directives).
    - `bytes` integer — The total number of bytes read from the cache.
  - `updating` object
    - `responses` integer — The total number of expired responses read from the cache while responses were being updated (see <a href="https://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_cache_use_stale_updating">proxy_cache_use_stale</a> and other “<code>*_cache_use_stale</code>” directives).
    - `bytes` integer — The total number of bytes read from the cache.
  - `revalidated` object
    - `responses` integer — The total number of expired and revalidated responses read from the cache (see <a href="https://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_cache_revalidate">proxy_cache_revalidate</a> and other “<code>*_cache_revalidate</code>” directives.
    - `bytes` integer — The total number of bytes read from the cache.
  - `miss` object
    - `responses` integer — The total number of responses not found in the cache.
    - `bytes` integer — The total number of bytes read from the proxied server.
    - `responses_written` integer — The total number of responses written to the cache.
    - `bytes_written` integer — The total number of bytes written to the cache.
  - `expired` object
    - `responses` integer — The total number of expired responses not taken from the cache.
    - `bytes` integer — The total number of bytes read from the proxied server.
    - `responses_written` integer — The total number of responses written to the cache.
    - `bytes_written` integer — The total number of bytes written to the cache.
  - `bypass` object
    - `responses` integer — The total number of responses not looked up in the cache due to the <a href="https://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_cache_bypass">proxy_cache_bypass</a> and other “<code>*_cache_bypass</code>” directives.
    - `bytes` integer — The total number of bytes read from the proxied server.
    - `responses_written` integer — The total number of responses written to the cache.
    - `bytes_written` integer — The total number of bytes written to the cache.

## Other responses

- `404` — Cache not found (*CacheNotFound*), unknown version (*UnknownVersion*)

---

[API](https://skmtc.dev/nginx/apis/nginx-plus-rest-api.md) · [All operations](https://skmtc.dev/nginx/apis/nginx-plus-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nginx/nginx-plus-rest-api/revisions/533ae7834228/schema)