Skip to Content
SDKsSDK overview

SDK overview

Every official SDK is a real, versioned, open-source repository that mirrors the REST API one-to-one. Pick a language and read the full A-to-Z guide for it.

Feature matrix

CapabilityPythonTypeScriptGo
Send one SMS
Send many (client-side, paced)send_manysendManySendMany
Server-side bulk SMSbulk (cap 100)bulk (cap 100)Bulk (cap 100)
Message logslogslogs / logsJwtLogs
Local SMS part analysisanalyzegetSmsPartInfoAnalyze
Phone normalization✅ (automatic)✅ (opt-out)✅ (automatic)
Credits balance & history
Public rate card
Sender-ID registration
Voucher top-ups
Webhook verification/parsing✅ (code samples)Webhooks.Parse
Async supportAsyncSendAfrica✅ (native await)— (goroutines)
Retries & backoff✅ 500 ms → 8 s✅ 1 s → 8 s + jitter✅ 500 ms → 8 s
Error taxonomy✅ exceptions✅ error classesAPIError

Shared concepts

No matter which SDK you pick, these ideas are identical:

  1. One client, one API key. Construct the client with your key (X-API-Key is set automatically).
  2. Typed results. Responses map to typed models — SMSResult, CreditBalance, RateInfo, WebhookEvent
  3. Automatic retries. 429/5xx and network failures retry with backoff, honoring Retry-After.
  4. Delivery is async. Send responses confirm provider acceptance. Delivery arrives later via webhooks.
  5. One credit per SMS part. Use the local analysis helpers to predict cost before sending.

Full guides

  • Go SDK — 20+ pages: setup, sending, bulk, credits, rates, sender IDs, vouchers, webhooks, contacts, campaigns, notifications, and utilities.
  • Python SDK — setup, sending, bulk, async, CLI, credits, rates, sender IDs, vouchers, webhooks, and errors.
  • TypeScript SDK — setup, sending, bulk, credits, rates, sender IDs, vouchers, webhooks, and errors.

Under the hood

The SDKs call the SendAfrica REST API at https://api.sendafrica.online/v1. All three are generated from the same contract, so if you already know the HTTP endpoint, you already know the SDK method name.

Last updated on