---
title: "Get an SLO's burn-down history"
method: GET
path: "/slos/{sloId}/snapshots"
tags: ["SLOs"]
---

# Get an SLO's burn-down history

`GET /slos/{sloId}/snapshots`

## Request

- Base URL: `https://api.marboba.com/v1`
- URL: `https://api.marboba.com/v1/slos/{sloId}/snapshots`
- Auth: HTTP bearer

Returns up to `limit` snapshots in ascending takenAt order. The sloCalculator writes one snapshot per SLO every 15 minutes, so the default 500-snapshot limit covers ~5 days of history. Use this to power a burn-down chart in your dashboard.

## Response `200`

List of snapshots

- object
  - `snapshots` SloSnapshot[]
    - `id` string
    - `takenAt` string, date-time, nullable
    - `currentValue` number, nullable
    - `errorBudgetTotal` number, nullable
    - `errorBudgetRemaining` number, nullable
    - `errorBudgetPercentUsed` number, nullable
    - `status` string, nullable

## Other responses

- `404` (unresolved $ref)

---

[API](https://skmtc.dev/marboba/apis/marboba-public-rest-api.md) · [All operations](https://skmtc.dev/marboba/apis/marboba-public-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/marboba/apis/marboba-public-rest-api/revisions/5b96d525d88d?raw)