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

# Get SMS Balance

Get current SMS balance and usage information.

<Warning>
  Requires authentication. Include the access token in the Authorization header.
</Warning>

## Success Response (200)

<ResponseField name="balance" type="object">
  Balance information object
</ResponseField>

<ResponseField name="balance.credits" type="integer">
  Current SMS credits
</ResponseField>

<ResponseField name="balance.currency" type="string">
  Currency code
</ResponseField>

<ResponseField name="balance.last_updated" type="string">
  Last update timestamp (ISO 8601)
</ResponseField>

<ResponseField name="usage" type="object">
  Usage information object
</ResponseField>

<ResponseField name="usage.used_this_month" type="integer">
  SMS credits used this month
</ResponseField>

<ResponseField name="usage.remaining" type="integer">
  Remaining SMS credits
</ResponseField>

<ResponseExample>
  ```json theme={null}
  {
    "balance": {
      "credits": 1000,
      "currency": "USD",
      "last_updated": "2025-11-27T10:30:00Z"
    },
    "usage": {
      "used_this_month": 500,
      "remaining": 500
    }
  }
  ```
</ResponseExample>