Skip to main content
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: 
curl -X GET "https://relay.snipp.gg/usage-history" \
  -H "relay-key: YOUR_RELAY_KEY"

​
Responses

{
  "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
  }
}