---
title: "Returns paginated cache times"
method: GET
path: "/cache-times"
tags: ["cache times", "private"]
---

# Returns paginated cache times

`GET /cache-times`

Returns a paginated list of cache times

## Query parameters

- `offset` integer
- `limit` integer
- `release_time` string

## Response `200`

Successfully returned paginated cache times

- object
  - `count` integer — The number of cache times returned in the current response
  - `items` CacheTime[]
    - `id` string, required — Unique identifier for a cache time, represented as an MD5 hash of the path
    - `path` string, required — Path for which caching is set
    - `collection_id` string — Collection ID - used for grouping and filtering of cache time objects
    - `release_time` string, date-time — Release time in ISO-8601 format
  - `limit` integer — The limit submitted for items to return
  - `offset` integer — The number of items skipped before starting to collect the result set
  - `total_count` integer — Total number of cache times available

## Other responses

- `400` — Invalid request, reasons can be one of the following: invalid offset, limit or release_time format
- `500` — Failed to process the request due to an internal error

---

[API](https://skmtc.net/office-of-national-statistics/apis/legacy-cache-api.md) · [All operations](https://skmtc.net/office-of-national-statistics/apis/legacy-cache-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/office-of-national-statistics/legacy-cache-api/revisions/eea11da5c81c/schema)