# Check balance (POST alias)
URL: /docs/api-reference/authentication-balance/checkBalancePost

## POST `/api/v1/public/sms/balance`

**Summary:** Check balance (POST alias)
**Operation ID:** `checkBalancePost`

Alternative POST endpoint for querying wallet and credit balances in restricted enterprise network environments.

**Authentication:** `X-Api-Key: sk_live_...` or `Authorization: Bearer sk_live_...`

### Responses

- **`200`**: Current account balance details

```json
{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "example": "success"
    },
    "data": {
      "type": "object",
      "properties": {
        "balance": {
          "type": "number",
          "example": 250,
          "description": "Monetary PAYG wallet cash balance"
        },
        "smsUnits": {
          "type": "integer",
          "example": 1000,
          "description": "Prepaid SMS unit credits remaining"
        },
        "currency": {
          "type": "string",
          "example": "GHS",
          "description": "Account settlement currency"
        }
      }
    }
  }
}
```
- **`401`**: Authentication failed or API key missing
- **`403`**: API key lacks required scope (e.g. sms:send, mfa:write, balance:read)