---
title: "Service: /caches/{name}/elements [GET]"
source: https://dev.pageseeder.com/api/services/list-cache-elements-GET.html
description: "Retrieves a paginated list of elements in a specified cache. Requires administrator permissions. Returns cache element details including keys, creation times, expiration times, and hit counts with configurable page size."
last_updated: 2026-09-02T11:36:12+10:00
document_type: api_endpoint
operation_id: cache-GET
resource_id: cache
path_template: /caches/{name}/elements
http_method: GET
api_category: cache
implementation_version: 6.2004
api_since: 5.5000
deprecated_since: null
obsolete_since: null
api_support: experimental
cache_control: null
generated_at: 2026-09-02
tokens: ~357
---

# /caches/\{name\}/elements \[GET\]

## Description

Return the list of elements in a specific cache.

To retrieve the list of valid cache names, use the [/caches \[GET\]](cache-summary-GET.md) service.

## Parameters

| Name | Description | Required | Type | Default value |
| --- | --- | --- | --- | --- |
| page | The page to load | no | integer | `1` |
| pagesize | The number of cached elements per page | no | integer | `5000` |

This service implements [paging](../usage/parameters.md), pages are based on the number of cached elements.

## Permission

This service requires administrator.

## Response

The output has the following format:

```xml

<cache name="xml-documents"
guid="MY-PC/123.456.789.012-d484acdc-1040-42e9-9eae-8413ab5f9519"
       status="STATUS_ALIVE"
       disabled="false">
  <keys page="1"
        pagesize="5000"
        limitreached="false"
        count="280">
    <element key="777-25913-"
             creation-time="2015-11-10T15:54:53+11:00"
             expiration-time="292278994-08-17T17:12:55+10:00"
             last-access-time="2015-11-10T15:54:53+11:00"
             last-update-time="2015-11-10T15:54:52+11:00"
             hit-count="0"
             version="1"
             time-to-idle="0"
             time-to-live="0"
             eternal="true"
             expired="false"/>
    ...
  </keys>
</cache>
```

## Error Handling

No specific errors expected for this service.