---
title: "Read current available and reserved credits"
method: GET
path: "/credits/balance"
tags: ["Credits"]
---

# Read current available and reserved credits

`GET /credits/balance`

## Request

- Base URL: `https://api.flashdata.dev/v2`
- URL: `https://api.flashdata.dev/v2/credits/balance`
- Auth: API key in cookie `__Host-fd_session`

## Response `200`

Credit balance

- CreditBalance
  - `balanceCredits` number, required: Signed settled balance after grants, usage, refunds and provider reversals.
  - `reservedCredits` number, required
  - `availableCredits` number, required: max(balanceCredits, 0).
  - `lifetimeGrantedCredits` number, required
  - `lifetimeUsedCredits` number, required
  - `lifetimeRefundedCredits` number, required: Credits returned to the account after failed usage.
  - `lifetimePaymentReversedCredits` number, required: Absolute Credits removed after verified provider refunds or chargebacks.
  - `updatedAt` string, date-time, required

## Other responses

- `401`: Authentication required or invalid

---

[API](https://skmtc.dev/flashdata/apis/flashdata-customer-api.md) · [All operations](https://skmtc.dev/flashdata/apis/flashdata-customer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/flashdata/apis/flashdata-customer-api/revisions/109179fe9313?raw)