---
title: "Plan, credits and the last 30 days"
method: GET
path: "/usage"
tags: ["Usage"]
---

# Plan, credits and the last 30 days

`GET /usage`

## Request

- Base URL: `https://app.vulk.dev/api/v1`
- URL: `https://app.vulk.dev/api/v1/usage`
- Auth: HTTP bearer

Scope `usage.read`.

## Response `200`

The account's plan and usage.

- Usage: `plan`, `billingInterval`, `monthlyCredits` and `renewsAt` are null without a subscription.
  - `plan` string, nullable
  - `status` 'active' | 'trialing' | 'past_due' | 'none', required
  - `billingInterval` 'month' | 'year', nullable
  - `monthlyCredits` number, nullable
  - `renewsAt` string, date-time, nullable
  - `creditBalance` number, required
  - `creditsUsedLast30Days` number, required
  - `generationsLast30Days` integer, required
  - `failedGenerationsLast30Days` integer, required
  - `modelsUsedLast30Days` string[], required

## Other responses

- `401`: No key, a malformed key, or a revoked or expired one (code UNAUTHORIZED).
- `403`: The key lacks the scope the endpoint needs (code FORBIDDEN).
- `429`: Over 60 requests in a minute; wait `retryAfter` seconds (code RATE_LIMITED).

---

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