---
title: "Get historical data of billing and usage for a wallet address."
method: GET
path: "/v1/usage/history"
tags: ["Billing"]
---

# Get historical data of billing and usage for a wallet address.

`GET /v1/usage/history`

## Query parameters

- `address` string, required — The wallet address to get billing and usage data for
- `startDate` string, date — Start date (YYYY-MM-DD). Defaults to 30 days before endDate
- `endDate` string, date — End date (YYYY-MM-DD). Defaults to today by UTC 23:59:59

## Response `200`

Returns billing and usage data

- object[]
  - `date` string, required — Date in YYYY-MM-DD format
  - `activeDeployments` number, required — Number of active deployments on this date
  - `dailyAktSpent` number, required — AKT tokens spent on this date
  - `totalAktSpent` number, required — Cumulative AKT tokens spent up to this date
  - `dailyUsdcSpent` number, required — USDC spent on this date
  - `totalUsdcSpent` number, required — Cumulative USDC spent up to this date
  - `dailyActSpent` number, required — ACT spent on this date (includes legacy USDC)
  - `totalActSpent` number, required — Cumulative ACT spent up to this date (includes legacy USDC)
  - `dailyUsdSpent` number, required — Total USD value spent on this date (AKT + USDC)
  - `totalUsdSpent` number, required — Cumulative USD value spent up to this date

## Other responses

- `400` — Invalid address format

## Changes

- **2026-08-11** `ae76edbfc7f2` — 1 breaking
  - for the `query` request parameter `endDate`, default value `2026-07-20` was removed
- **2026-07-20** `c3b0e234fc13` — 1 breaking
  - for the `query` request parameter `endDate`, default value was changed from `2026-06-26` to `2026-07-20`
- **2026-06-26** `be2e5614d754` — 1 breaking
  - for the `query` request parameter `endDate`, default value was changed from `2026-06-17` to `2026-06-26`
- **2026-06-17** `b1975c50c4ba` — 1 breaking
  - for the `query` request parameter `endDate`, default value was changed from `2026-05-20` to `2026-06-17`
- **2026-05-20** `1f950a9aba80` — 1 breaking
  - for the `query` request parameter `endDate`, default value was changed from `2026-05-14` to `2026-05-20`

[Full history](https://skmtc.dev/akash-network/apis/akash-network-console-api/changes/v1/usage/history/get.md)

---

[API](https://skmtc.dev/akash-network/apis/akash-network-console-api.md) · [All operations](https://skmtc.dev/akash-network/apis/akash-network-console-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/akash-network/akash-network-console-api/revisions/77a0df47eb74/schema)