---
title: "Check remaining credits"
method: POST
path: "/api/credits"
tags: ["Account"]
---

# Check remaining credits

`POST /api/credits`

## Request

- Base URL: `https://app.pedra.ai`
- URL: `https://app.pedra.ai/api/credits`
- Auth: none required

Returns the account plan and remaining credit balance. Read-only — never deducts credits. Also available as `GET /api/credits?apiKey=YOUR_API_KEY`.

## Request body

- object
  - `apiKey` string, required: Account API key, sent in the request body. Get one at https://app.pedra.ai under Settings → API.

## Response `200`

Current plan and credit balance.

- object
  - `plan` string: Account plan.
  - `creditsRemaining` integer: Credits available for generations.

## Other responses

- `404`: Missing, invalid, or revoked API key.
- `405`: Wrong HTTP method — all endpoints accept POST (credits also accepts GET).

---

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