---
title: "Get account or owned-key daily rollups"
method: GET
path: "/v1/usage"
tags: ["Account"]
---

# Get account or owned-key daily rollups

`GET /v1/usage`

## Request

- Base URL: `https://api.scripthaul.com`
- URL: `https://api.scripthaul.com/v1/usage`
- Auth: HTTP bearer

Without resource, daily usage rollups for the account or one owned key. With resource=ledger, the append-only credit ledger (newest first) paged with limit and offset; the CSV format applies to rollups only.

## Query parameters

- `resource` 'ledger'
- `from` string, date
- `to` string, date
- `key_id` string, uuid
- `format` 'json' | 'csv'
- `limit` integer
- `offset` integer
- `cursor` string
- `since` string, date-time
- `until` string, date-time

## Response `200`

JSON rollups or CSV attachment

## Other responses

- `400`: Typed API error
- `401`: Typed API error
- `403`: Typed API error

---

[API](https://skmtc.dev/scripthaul/apis/scripthaul-api.md) · [All operations](https://skmtc.dev/scripthaul/apis/scripthaul-api/llms.txt) · [OpenAPI document](https://skmtc.dev/scripthaul/apis/scripthaul-api/revisions/f476d69f4a6b?raw)