---
title: "Credit balance and plan"
method: GET
path: "/api/v1/usage"
---

# Credit balance and plan

`GET /api/v1/usage`

## Request

- Base URL: `https://podcaststotext.com`
- URL: `https://podcaststotext.com/api/v1/usage`
- Auth: HTTP bearer

Worth checking before a long episode or a batch.

## Response `200`

Current usage

- object
  - `plan` string
  - `credits_remaining_minutes` number: Total minutes this key can spend: the plan allowance plus any purchased minutes.
  - `plan_allowance_minutes` number: The plan's monthly allowance. Resets each billing period and is also spendable in the web app.
  - `purchased_minutes` number: Minutes bought as packs. They do not reset monthly, and are spendable through this API and MCP only, while the plan includes API access.
  - `transcriptions_total` integer
  - `scopes` string[]

## Other responses

- `401`: Missing or invalid API key

---

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