Skip to Content
API Reference

API Reference

The SDKs are thin, fully-typed wrappers around the SendAfrica REST API. Every SDK method maps to an HTTP endpoint and returns the same response envelope.

Base URL

https://api.sendafrica.online/v1

Core endpoints

EndpointMethodSDK pages
/v1/sms/POST — send one SMSGo · Python · TypeScript
/v1/sms/bulkPOST — send one message to manyGo · Python · TypeScript
/v1/sms/logsGET — message logsGo · Python · TypeScript
/v1/credits/balanceGETGo · Python · TypeScript
/v1/credits/historyGETGo · Python · TypeScript
/v1/rates · /v1/rates/{country}GET — public rate cardGo · Python · TypeScript
/v1/sender-ids + /v1/sender-ids/{id}GET/POST/PUTGo · Python · TypeScript
/v1/vouchers · /v1/vouchers/rateGET/POST — top up creditsGo · Python · TypeScript

Authentication

API keys are sent as X-API-Key (and Authorization: Bearer) on every request automatically. See Authentication.

Response envelope

Every response wraps in a standard shape:

{
  "success": true,
  "data": { },
  "request_id": "dfffa252-4781-43ff-8e1a-bf01a754d66a"
}

Errors use "success": false, an error object with code and message, and the same request_id for tracing — see Error Handling.

Full REST documentation

For the complete OpenAPI contract, machine-readable openapi.json, and additional API-only endpoints (webhook management, voucher OTP, rate-card metadata), see the main developer documentation .

Last updated on
Rate Limits