---
title: "Caption allowance, wallet balance, and reservations"
method: GET
path: "/v1/usage"
tags: ["account"]
---

# Caption allowance, wallet balance, and reservations

`GET /v1/usage`

## Request

- Base URL: `https://api.transcriptdock.com`
- URL: `https://api.transcriptdock.com/v1/usage`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `sb-access-token`

## Response `200`

Current plan, allowance, and wallet in USD strings

- Usage
  - `plan` string, required: Current plan: trial, wallet_only, starter, pro or scale.
  - `period_end` string, date-time, nullable: When the current monthly allowance resets; null on trial.
  - `credits_remaining` integer, required: Credits available right now: allowance left this period plus prepaid credits, minus holds.
  - `credits_total` integer, required: Allowance granted this period plus prepaid credits.
  - `credits_reserved` integer, required: Credits held by running jobs.
  - `prepaid_credits` integer, required: Purchased credits (never expire), net of holds.
  - `transcribe_credits_per_minute` integer, required: Credits per started minute of AI transcription.
  - `minimum_billable_seconds` integer, required: Every AI transcription bills at least this many seconds.

---

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