Get cache size

GET/api/storage

Size of the cache, how many rows will expire soon, and cache traffic over the last 7 days. The hit rate is cacheHits7d / requests7d. The 7-day counts come from the request log, which keeps entries after their cache rows are deleted, so they can be non-zero while total is 0.

Response

200 · application/json

Cache statistics.

totalinteger

Conversions in the cache.

expiringSooninteger

Conversions that will be deleted by retention within the next 10 days. 0 when retention is unlimited.

oldeststring

When the oldest conversion was written (UTC). null when the cache is empty.

retentionDaysinteger

How long conversions are kept (PULLMD_CACHE_RETENTION_DAYS). 0 means forever.

dbSizeBytesinteger

Size of the SQLite database file, in bytes.

cacheHits7dinteger

Requests served from the cache in the last 7 days.

requests7dinteger

All requests in the last 7 days.

cURL

curl --request GET \
  --url 'http://localhost:3000/api/storage'

{
  "total": 4,
  "expiringSoon": 0,
  "oldest": "2026-10-19 00:37:14",
  "retentionDays": 90,
  "dbSizeBytes": 208896,
  "cacheHits7d": 4,
  "requests7d": 13
}