Home Features Developers Pricing Documentation
Login Start Free

API Terms of Use

1. Scope of These API Terms

These API Terms of Use apply in addition to the Terms and Conditions whenever you access the Twatumi REST API, using either a live (tw_live_) or test (tw_test_) API token. In the event of a conflict, these API Terms govern your use of the API specifically.

2. API Tokens

API tokens are issued per organisation and must be kept confidential. You are responsible for all requests made using your tokens, whether or not authorised by you. If a token is compromised, revoke it immediately from the Dashboard and issue a new one — we are not liable for losses arising from a token you failed to secure.

We may revoke or rotate a token at any time if we reasonably believe it has been compromised or is being used in violation of these Terms.

3. Test vs Live Environment

Test tokens (tw_test_) are provided for development and integration testing, do not send live messages, and do not incur per-segment charges, but remain subject to the Acceptable Use Policy. Live tokens (tw_live_) send real messages, are billed against your wallet, and are subject to your organisation’s current monthly platform fee. Test credentials must not be used to send production traffic.

4. Rate Limits and Usage Limits

API usage is subject to the requests-per-minute, daily and monthly SMS limits of your assigned pricing plan, shown in your Dashboard. We may throttle or reject requests that exceed these limits, and may apply additional temporary limits to protect platform stability.

5. Fees

API usage is billed according to the Fees, Billing and the Wallet section of the Terms and Conditions. Each SMS segment sent via the API is charged at your plan’s per-segment rate.

6. Webhooks

If you configure a webhook endpoint, we attempt to deliver delivery-status and event notifications to it, signed so you can verify authenticity. We retry failed deliveries with exponential backoff for up to 8 attempts before giving up; you are responsible for ensuring your endpoint is available and responds promptly, and for verifying the signature before trusting a payload.

7. Idempotency and Integration Behaviour

Where you supply an idempotency key on a send request, we honour it for 24 hours to prevent duplicate sends on retry. Integration behaviour — segment limits, encoding handling, error codes — follows the API reference documentation current at the time of your request; we may evolve the API but will avoid breaking changes to a stable version without reasonable notice.

8. Acceptable Use

All use of the API is subject to the Acceptable Use Policy. We may suspend API access, independently of your Dashboard access, if we detect abuse, fraud, or a violation of that Policy.

9. Suspension of API Access

We may suspend or revoke API access immediately if required to protect the Service, our upstream providers, or other users — including in response to a spike in complaints, delivery failures, or suspected fraud — and will restore access once the issue is resolved where appropriate.

10. Disclaimer

The API is provided “as is”. We do not guarantee that the API, or any particular version of it, will be available uninterrupted, or that message delivery will succeed, as delivery depends on factors outside our control including upstream mobile networks.

11. Contact

For API support, integration questions, or to report a security issue, contact varde@simaneka.com or submit a support request from your Dashboard.

Simaneka Intellectual Technologies · Twatumi SMS infrastructure · Last updated 16 Nov 2026