---
title: "Get cache metrics"
method: GET
path: "/caches/{cache}/metrics"
tags: ["Caches"]
---

# Get cache metrics

`GET /caches/{cache}/metrics`

## Request

- Base URL: `https://cloud.laravel.com/api`
- URL: `https://cloud.laravel.com/api/caches/{cache}/metrics`
- Auth: HTTP bearer

Get metrics for a specific cache.

`size.total` is the latest size. `bandwidth_usage.total` is the bandwidth used so far this calendar month,
whatever the period.

## Path parameters

- `cache` string, required

## Query parameters

- `period` '1h' | '6h' | '24h' | '3d' | '7d' | '30d'

## Response `200`

- object
  - `data` object, required
    - `hits_and_misses` object, required
      - `labels` string[], required
      - `average` number[], required
      - `data` object[], required
        - `x` string, required
        - `y` number[], required
    - `throughput` object, required
      - `labels` string[], required
      - `average` number[], required
      - `data` object[], required
        - `x` string, required
        - `y` number[], required
    - `size` object, required
      - `data` object[], required
        - `x` string, required
        - `y` number, required
      - `total` number, required
    - `bandwidth_usage` object, required
      - `data` object[], required
        - `x` string, required
        - `y` number, required
      - `total` number, required
  - `meta` object, required
    - `period` string, required
    - `available_periods` string[], required

## Other responses

- `403`: Authorization error
- `404`: Not found
- `422`: Validation error

---

[API](https://skmtc.dev/laravel/apis/laravel-cloud.md) - [All operations](https://skmtc.dev/laravel/apis/laravel-cloud/llms.txt) - [OpenAPI document](https://skmtc.dev/laravel/apis/laravel-cloud/revisions/af603f54ff33?raw)