Reference

Changelog

What changed, by API version. Changes within a version only add.

The path is /v1; the dated version is the Jusa-Version header. Your account is pinned to the version it started on. Supported: 2026-10-01.

2026-10-01 · Jusa for Developers

1 October 2026

  • The API at /dev/v1: sends of airtime, data and ZESA; batches; schedules; recipients, groups and cost centres; programs, rewards, reward links, escrow and fraud review; Jusa Credit, top-ups and statements; checkout sessions; reports and exports; webhooks v2 and the events feed.
  • Test mode on every account: a sandbox with its own Jusa Credit, magic numbers and meters, and test helpers.
  • Keys v2: secret, restricted, publishable and agent keys; scopes; spend caps; IP allowlists; rolls with a grace period.
  • The MCP server for AI agents, with approval by a person over a threshold or to a new number.
  • SDKs for Python (jusa) and Node (@jusa/node), the jusa CLI, a Postman collection and this OpenAPI 3.1 document.
  • Later sends (scheduled_for), a ZESA send's meter changed before it goes, retrying a failed send after Hot Recharge is asked, a send's attempts, and receipts and statements as PDF.
  • Rate Watch at /zesa/rate, /series, /quote and /observations; the activity feed; a person's statement; combining one schedule run into another.
  • metadata[key] filters on every list with metadata, expand[] on sends and rewards, and an SMS that names you (statement_descriptor) in English, Shona or Ndebele.