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

> ## Agent Instructions
> Use Gomobile customer-facing vocabulary.
> Do not infer support for internal, hidden, experimental, or unreleased features.

# Credits API

> Read the workspace credit balance with an Admin API key.

The credit-balance endpoint requires an **Admin** API key. Manager and Agent keys receive `403`. Human workspace owners and administrators can manage keys, but `owner` is not an API-key role.

The endpoint is read-only. It does not add credits and does not publish pricing or deduction rules.

## Get the balance

`GET /credits/balance`

```bash theme={null}
curl "$GOMOBILE_API_BASE_URL/credits/balance" \
  -H "X-API-Key: $GOMOBILE_API_KEY"
```

Example `200` response:

```json theme={null}
{ "balance": 125.5 }
```

Treat the numeric balance as the current platform value. Do not infer a currency conversion, per-call price, or billing commitment from this response.

## Troubleshooting

Common balance failures are `401` for an invalid key and `403` for a Manager or Agent key.


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