---
title: "Get credit usage history"
method: GET
path: "/v3/billing/usage-history/"
tags: ["Billing"]
---

# Get credit usage history

`GET /v3/billing/usage-history/`

Returns credit-consuming activity for the team's organization, newest first - what each charge was for, when, which brand, and how many credits. Filter with q, teams, categories (snowy | ai-visibility | content | seo-audit | knowledge-base | other), creditMin/creditMax and startDate/endDate (inclusive calendar days, resolved in `timeZone`). Returns one page plus a nextCursor; pass it back as `cursor` to keep reading, and keep going before concluding a total. Use for questions like 'what did I spend credits on' or 'why did my balance drop'.

## Query parameters

- `teamId` string
- `limit` string
- `cursor` string
- `q` string
- `teams` string
- `categories` string
- `creditMin` number
- `creditMax` number
- `startDate` string
- `endDate` string
- `timeZone` string

## Other responses

- `400` — Default Response
- `500` — Default Response

## Changes

- **2026-09-10** `a63b6be50d97` — 1 info
  - added the new optional `query` request parameter `timeZone`
- **2026-09-09** `443005424e10` — 2 info
  - added the new optional `query` request parameter `endDate`
  - added the new optional `query` request parameter `startDate`
- **2026-08-05** `95c8984f5d48` — 1 breaking, 1 info
  - added the pattern `^(all|[1-9][0-9]*)$` to the `query` request parameter `limit`
  - for the `query` request parameter `limit`, the type was generalized from `integer` to `string`

[Change history](https://skmtc.dev/snowseo/apis/snowseo-api/changes/v3/billing/usage-history/get.md)

---

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