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

# Get usage history

> Usage history data

### Query parameters

<ParamField query="start_date" type="string (date)">
  Start date
</ParamField>

<ParamField query="end_date" type="string (date)">
  End date
</ParamField>

<ParamField query="granularity" type="string">
  hourly, daily, or monthly
</ParamField>

### Response

`object`

<ResponseField name="granularity" type="string" required />

<ResponseField name="start_date" type="string (date-time)" required />

<ResponseField name="end_date" type="string (date-time)" required />

<ResponseField name="data" type="object[]" required>
  <Expandable title="data">
    <ResponseField name="period_start" type="string (date-time)" required />

    <ResponseField name="period_end" type="string (date-time)" required />

    <ResponseField name="cpu_hours" type="number" required />

    <ResponseField name="memory_gb_hours" type="number" required />

    <ResponseField name="network_gb" type="number" required />

    <ResponseField name="sandbox_creations" type="integer" required />

    <ResponseField name="sandbox_count" type="integer" required />
  </Expandable>
</ResponseField>

### Status codes

| Code  | Meaning            |
| ----- | ------------------ |
| `200` | Usage history data |

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url 'https://api.sandbox.stateset.app/api/v1/usage/history' \
    --header "Authorization: Bearer $STATESET_SANDBOX_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "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
      }
    ]
  }
  ```
</ResponseExample>