---
title: "Get credit balance and usage"
method: GET
path: "/api/v1/credits"
tags: ["Credits"]
---

# Get credit balance and usage

`GET /api/v1/credits`

## Request

- Base URL: `https://investormatch.pro`
- URL: `https://investormatch.pro/api/v1/credits`
- Auth: HTTP bearer

Returns your purchased credit balance, remaining free monthly calls, lifetime usage, and this month's usage. Authenticated and rate-limited.

## Response `200`

Current credit balance and usage.

- CreditBalance
  - `balance` integer: Purchased credits remaining.
  - `free_calls_remaining` integer: Free monthly calls left before credits are charged.
  - `total_used` integer: Lifetime credits consumed.
  - `monthly_usage` integer: Calls made in the current month.

## Other responses

- `401`: Missing or invalid API key.
- `429`: Rate limit exceeded.

---

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