---
title: "List Scalr Usage Statistics"
method: GET
path: "/usage-statistics"
tags: ["usage-statistics"]
---

# List Scalr Usage Statistics

`GET /usage-statistics`

This endpoint returns billing usage statistics for an account within a period of time.

Required permission: accounts:billing

## Query parameters

- `filter[date]` string, required
- `filter[account]` string
- `breakdown_by` 'account' | 'environment' | 'workspace'
- `total` string

## Response `200`

Success.

## Other responses

- `403` — User unauthorized to perform the action.
- `404` — Account or environment not found.
- `4XX` — Client error.
- `5XX` — Server error.

---

[API](https://skmtc.net/scalr/apis/scalr-iacp-api.md) · [All operations](https://skmtc.net/scalr/apis/scalr-iacp-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/scalr/scalr-iacp-api/revisions/fc927526ad12/schema)