Introduction

The Timisha Solutions REST API lets you send SMS, run bulk campaigns, collect survey responses, and build USSD menus, all over simple HTTPS requests.

Every endpoint is served over HTTPS and speaks JSON. The base URL is the same for every request:

Base URL

https://timisha-solutions-api.salamu.co.ke/api/v1

Response envelope

Every response wraps its payload in a consistent envelope. Always check success before reading data.

json

// Success
{ "success": true, "data": { ... } }

// Success — paginated list
{ "success": true, "data": [...], "meta": { "total": 142, "page": 1, "page_size": 20 } }

// Error
{ "success": false, "error": "human-readable message" }

Two products, one API

SMS platform

Sender IDs, keywords, contacts, groups, messaging, bulk campaigns, and surveys.

USSD platform

USSD codes, extensions, a visual menu builder, session simulation, and carrier webhooks.

Authentication in one line

Generate an API token in your dashboard and send it as a Bearer header on every request:

http

Authorization: Bearer YOUR_API_TOKEN

New here?

Start with the Quickstart to send your first message in a couple of minutes, then read Authentication for token scopes.

Next steps

Quickstart, send your first SMS.
Authentication, tokens, scopes, and headers.
Send a message, the core SMS endpoint.
Errors & status codes, what each response means.

Get started