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

# Solde d’unités

> Le solde appartient au projet.

Chaque projet achète et consomme ses propres unités SMS. Ses deux environnements le partagent, et le staging le lit sans jamais le débiter.

```bash theme={null}
curl https://api.dexnotify.com/api/v1/sms/balance -H "x-api-key: $DEXNOTIFY_CLE"
```

```json theme={null}
{ "available": 12480, "reserved": 120, "consumedThisMonth": 3310 }
```

* **`available`** : ce qui peut partir maintenant.
* **`reserved`** : retenu pour des envois en cours ou programmés. Les unités d’un SMS non remis reviennent au solde.
* Une clé API ne lit que le solde **de son projet**.

## Acheter

Les unités s’achètent depuis le dashboard, **SMS › Achats**, jamais par clé API.

## Être prévenu

Le seuil d’alerte se règle dans le dashboard. Quand le solde passe dessous, le [webhook](https://docs.dexnotify.com/webhooks.md) `sms.balance.low` part avec `projectId`, `available` et `threshold`.

Un envoi que le solde ne couvre pas répond `402 INSUFFICIENT_BALANCE`, sans rien envoyer.


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