Get Account Balance

This is useful for:

• pre-flight credit checks before sending campaigns
• monitoring available balance in dashboards and billing systems
• alerting when your account balance is low

Endpoint title

Get Account Balance

What this endpoint does

Returns the real-time credit balance, last updated timestamp, and wallet currency for the authenticated Bulkit client account.

HTTP method and path

GET /api/v2/account/credits

Authorization requirements

This endpoint supports:

• Bearer token (recommended): Authorization: Bearer <api_key>
• Legacy headers: X-API-Key and X-API-Secret
• URL query parameter: ?apikey=<api_key>

Bearer token authorization is preferred.

Endpoint code block

GET https://api.bulkitsms.com/api/v2/account/credits

Authorization example

Authorization: Bearer bk_live_8n6JQv3K1h9Lp0Md

Request examples

curl -X GET "https://api.bulkitsms.com/api/v2/account/credits" \
  -H "Authorization: Bearer bk_live_8n6JQv3K1h9Lp0Md"

Parameters

This endpoint does not require a JSON request body.

Authentication parameters

Success response example

{
  "status": "success",
  "data": {
    "client_id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
    "balance": 2.97,
    "last_change": "2026-09-19T06:30:00Z",
    "currency": "KES"
  }
}

Error response examples

Invalid credentials

{
  "status": "error",
  "message": "Invalid API Key or Secret"
}

Unauthorized request

{
  "status": "error",
  "message": "Invalid API Key or Secret"
}

Notes and best practices

• Check balance before high-volume SMS or WhatsApp broadcasts.
• Use Authorization: Bearer <token> in production systems.
• Balances are returned as exact floating-point values (e.g. 2.97), enabling real-time micro-deductions per message unit.
• The currency field is typically KES.