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

# Returns paginated cache times

`GET /cache-times`

## Request

- Base URL: `/v1` (relative, and the document’s source URL is not known)
- URL: `/v1/cache-times`
- Auth: API key in header `Authorization`

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.dev/office-of-national-statistics/apis/legacy-cache-api.md) - [All operations](https://skmtc.dev/office-of-national-statistics/apis/legacy-cache-api/llms.txt) - [OpenAPI document](https://skmtc.dev/office-of-national-statistics/apis/legacy-cache-api/revisions/eea11da5c81c?raw)