---
title: "Read a prepaid credit balance + ledger"
method: GET
path: "/api/v1/storefront/credits/balance"
tags: ["Credits"]
---

# Read a prepaid credit balance + ledger

`GET /api/v1/storefront/credits/balance`

## Request

- Base URL: `https://propraven.com`
- URL: `https://propraven.com/api/v1/storefront/credits/balance`
- Auth: HTTP bearer

Return the balance and recent ledger for the credit token in the X-CREDIT-TOKEN header. No payment; the token is the credential (never a query param).

## Headers

- `X-CREDIT-TOKEN` string, required

## Response `200`

Balance + ledger.

- object

## Other responses

- `400`: A query or body parameter is invalid. Nothing was read or charged.
- `401`: Missing/invalid credit token.
- `405`: The endpoint exists but does not support this method. `Allow` lists the methods it does.
- `500`: Unexpected server error. The body never carries database or driver text.

---

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