> ## Documentation Index
> Fetch the complete documentation index at: https://docs.snipp.gg/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Usage History

Fetch your daily upload activity for the last 365 days, along with aggregate stats. This is the same data that powers the Upload Activity heatmap in the Snipp Console, exposed so you can rebuild it in your own tools.

## Behavior

* Authenticated with your `relay-key`. Returns activity for the key's owner only.
* `history` is ascending by date. Days with no uploads are omitted, so the array is sparse.
* `bytes` and `count` reflect successful uploads. A reservation that fails mid-upload is rolled back and does not appear.
* `stats.currentStreak` counts consecutive days with uploads ending on the current UTC day. It is `0` if you have not uploaded today.
* `stats.biggestDay` is `null` when there is no activity in the window.
* All dates are UTC.

## Examples

Fetch your usage history:

```bash theme={null}
curl -X GET "https://relay.snipp.gg/usage-history" \
  -H "relay-key: YOUR_RELAY_KEY"
```

## Responses

```json theme={null}
{
  "history": [
    {
      "day": "2026-05-12",
      "bytes": 5242880,
      "count": 3
    },
    {
      "day": "2026-05-14",
      "bytes": 1048576,
      "count": 1
    }
  ],
  "stats": {
    "totalBytes": 6291456,
    "totalUploads": 4,
    "activeDays": 2,
    "currentStreak": 1,
    "biggestDay": { "day": "2026-05-12", "bytes": 5242880 },
    "windowDays": 365
  }
}
```