Skip to main content
GET
Get Usage History
Fetch your daily upload activity for the last 365 days, with summary stats. This is the data behind the Upload Activity heatmap on the Billing & Usage settings page.

Behavior

  • Returns activity for the key’s owner only. Team keys get 401.
  • history is oldest first. Days with no uploads are left out, so the array is sparse.
  • bytes and upload_count count successful uploads only.
  • stats.upload_count and stats.total_bytes cover the whole 365-day window.
  • stats.current_streak counts consecutive days with uploads ending today (UTC). It is 0 if you have not uploaded today.
  • stats.biggest_day is null when there is no activity in the window.
  • All days are UTC, formatted YYYY-MM-DD.

Examples

Responses

Errors

Authorizations

relay-key
string
header
required

Your relay key from snipp.gg/settings/relay

Response

Success

history
object[]
required
stats
object
required