Get usage history

Usage history data

GET /api/v1/usage/history

cURL

curl --request GET \
  --url 'https://api.sandbox.stateset.app/api/v1/usage/history' \
  --header "Authorization: Bearer $STATESET_SANDBOX_API_KEY"

200

{
  "granularity": "hourly",
  "start_date": "2026-08-31T14:22:05Z",
  "end_date": "2026-08-31T14:22:05Z",
  "data": [
    {
      "period_start": "2026-08-31T14:22:05Z",
      "period_end": "2026-08-31T14:22:05Z",
      "cpu_hours": 1.5,
      "memory_gb_hours": 1.5,
      "network_gb": 1.5,
      "sandbox_creations": 1,
      "sandbox_count": 1
    }
  ]
}

Query parameters

start_date · string (date)

Start date

end_date · string (date)

End date

granularity · string

hourly, daily, or monthly

Response

object

granularity · string · required

start_date · string (date-time) · required

end_date · string (date-time) · required

data · object[] · required

Show data

period_start · string (date-time) · required

period_end · string (date-time) · required

cpu_hours · number · required

memory_gb_hours · number · required

network_gb · number · required

sandbox_creations · integer · required

sandbox_count · integer · required

Status codes

Code	Meaning
200	Usage history data

cURL

curl --request GET \
  --url 'https://api.sandbox.stateset.app/api/v1/usage/history' \
  --header "Authorization: Bearer $STATESET_SANDBOX_API_KEY"

200

{
  "granularity": "hourly",
  "start_date": "2026-08-31T14:22:05Z",
  "end_date": "2026-08-31T14:22:05Z",
  "data": [
    {
      "period_start": "2026-08-31T14:22:05Z",
      "period_end": "2026-08-31T14:22:05Z",
      "cpu_hours": 1.5,
      "memory_gb_hours": 1.5,
      "network_gb": 1.5,
      "sandbox_creations": 1,
      "sandbox_count": 1
    }
  ]
}