---
title: "List token usage"
method: GET
path: "/api/v1/account/usage"
tags: ["Account"]
---

# List token usage

`GET /api/v1/account/usage`

## Request

- Base URL: `https://api.vigotime.com`
- URL: `https://api.vigotime.com/api/v1/account/usage`
- Auth: none declared

Append-only ledger of billed operations: when, what, how much, which job.

Each record references the billed object (a solve's ``job_id``) and carries the balance
right after the debit, so a bill can be reconstructed line by line.

## Query parameters

- `limit` integer

## Response `200`

Successful Response

- UsageResponse: The caller's usage ledger, newest first.
  - `count` integer, required
  - `records` UsageRecord[], required
    - `at` string, required
    - `balanceAfter` integer, required
    - `cost` integer, required
    - `metadata` object, required
    - `operation` string, required
    - `reference` string, nullable, required

## Other responses

- `422`: Validation Error

---

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