---
title: "Get Credits"
method: GET
path: "/credits"
tags: ["credits"]
---

# Get Credits

`GET /credits`

Get the current credit balance for your account.

## Headers

- `Moda-Version` '2026-04-12' | '2026-05-01'

## Response `200`

Successful Response

- CreditBalanceResponse
  - `credits_remaining` integer, nullable — Current credit balance. Null if the billing service is unavailable or billing is not enabled for this account.
  - `plan` string, required — Current billing plan identifier (e.g. 'free', 'paid', 'ultra', 'enterprise'). Returns 'unlimited' when billing is not enabled.
  - `credits_limit` integer, nullable — Total credit allowance for the current billing period. Null if billing is not enabled.
  - `credits_reset_date` string, nullable — ISO 8601 date when credits reset for the current billing period. Null if billing is not enabled or reset date is unavailable.

## Other responses

- `401` — Authentication required.
- `403` — Permission denied for this scope.
- `404` — Resource not found.
- `409` — Conflict (idempotency / resource state).
- `422` — Request validation failed.
- `429` — Rate limit exceeded.
- `500` — Internal error.

---

[API](https://skmtc.dev/moda/apis/moda-public-api.md) · [All operations](https://skmtc.dev/moda/apis/moda-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/moda/moda-public-api/revisions/b34cb4cca59e/schema)