> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rawchunks.space/llms.txt
> Use this file to discover all available pages before exploring further.

# Read a Credits balance

> Read available purchased and promotional Credits.

Read available purchased and promotional Credits.

Use [request setup](https://docs.rawchunks.space/dev/guides/connect.md) for account headers.

## Authentication

Use [Credits authentication](https://docs.rawchunks.space/dev/guides/payments.md#pay-with-credits) for owner-scoped calls.

## Response

Returns `userAddress`, `availableAtomics`, `reservedAtomics`, `spentAtomics`, `suspendedAtomics`, `promo`, `packs`, `paypalClientId` and `environment`. Balance amounts use six-decimal USD atomic units. [Balance fields](https://docs.rawchunks.space/dev/guides/payments.md#read-the-balance).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.