Docs

Jusa API docs

Send airtime, data and ZESA tokens, and reward people, from one API.

Base URL https://jusa.localhost.co.zw/dev/v1. A test key (jusa_sk_test_…) reaches your sandbox and never moves real money; a live key (jusa_sk_live_…) does. Version 2026-10-01.

Start

10 minutes

QuickstartReward a survey response in test mode, then go live.

Sandbox

Test modeMagic numbers and meters for every outcome.

Tools

SDKs and toolsPython, Node, the CLI, Postman, OpenAPI and MCP.

Concepts

Keys and authenticationsk, rk, pk and ak keys; scopes; caps; rolling a key. ErrorsThe envelope, every code and every failure_code. IdempotencyRetry anything without paying twice. WebhooksSignatures, retries and the event catalogue. Settlement and moneyWhat happens to a send and its money, state by state.

Build

RecipesEvery use case, with the calls it takes.

Survey tools

KoboToolboxREST Services post each submission to a small relay that rewards it.

Survey tools

SurveyCTOA form webhook posts each submission to a relay that rewards it.

Survey tools

Google FormsAn Apps Script trigger rewards each response, no server of your own.

Survey tools

TypeformA signed Typeform webhook, checked, then rewarded.

Reference

API referenceEvery endpoint, its scope and its fields. OpenAPI 3.1The document everything here is built from. Postman collectionEvery request, with an Idempotency-Key where it needs one. ChangelogWhat changed, by version.