---
title: "Get Usage History Handler"
method: GET
path: "/v1/account/billing_history"
---

# Get Usage History Handler

`GET /v1/account/billing_history`

## Request

- Base URL: `https://api.lmnt.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.lmnt.com/v1/account/billing_history`
- Auth: none declared
- TypeScript: <https://skmtc.dev/lmnt/apis/yapster/docs/v1/account/billing_history/get.ts> (a function with typed inputs; its response is checked against the schema)

## Headers

- `x-api-key` string

## Cookies

- `lmnt-auth0` string, nullable

## Response `200`

Successful Response

- UsageHistoryItem[]
  - `plan` string, required
  - `period_end` integer, required
  - `chars_used` integer, required
  - `playground_chars_used` integer

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/lmnt/apis/yapster.md) - [All operations](https://skmtc.dev/lmnt/apis/yapster/llms.txt) - [OpenAPI document](https://skmtc.dev/lmnt/apis/yapster/revisions/f153248e1350?raw)