Heyrafiki

One rail for Care, Cover and Payments. Built in Nairobi, for Africa and the next billion People.

Website · Docs · Changelog · Vision · Open source

Heyrafiki connects People, Practitioners, Insurers and Organizations across Care, Benefits and Payments. Developers build against a versioned REST contract, typed SDKs, the hey command line and public documentation.

The documentation, API contract, assurance benchmark and SDK source are public. Organizations with Sandbox access can create a key in the Developer Platform. Request access.

Integration teams can review the contract and control model before requesting access:

The payer remains authoritative for membership, Benefit design, adjudication policy, premium, reserving and regulatory returns. Heyrafiki preserves the operational evidence connecting payer decisions to delivered Care, Claims and settlement.

The Open Mental Health Insurance Assurance Benchmark maps all 31 public API operations to 10 accountable capabilities and 9 controls. Its deterministic runner validates the contract, financial identities, a bitemporal Claim valuation timeline and graph integrity. Five adversarial mutations test duplicate events, reordered knowledge, future knowledge, unbalanced adjudication and settlement above payer liability.

git clone https://github.com/heyrafiki/proving-ground.git
cd proving-ground
npm ci
npm test

The open benchmark is the shared technical baseline for governed institutional pilots. Teams extend it with their operating assumptions, approved evidence and accountable reviewers while preserving the same reproducible contract. Call the Claim valuation operation, read the research article or inspect the machine-readable Assurance Graph.

First Light carries Screening signals into an accountable Practitioner review boundary. Its public evidence pack reproduces 48 versioned fixtures across self, caregiver and Practitioner responder paths. The suite verifies Consent before read or action, tenant isolation, minimum-necessary model context, blind dual review, effective and recorded time, complete audit evidence and 24 adverse boundaries.

Every artifact is pinned in a reviewed SHA-256 manifest. The Evidence Boundary keeps fixed-cohort conformance measurement precise while instrument- and population-specific clinical evaluation carries its own reviewed protocol.

We publish contracts, SDKs and documentation where independent inspection improves interoperability and trust. Each public artifact has its own licence.

Safety thresholds, anti-fraud controls, private regulator and payer adapters, production credentials and production data stay private. Read the open source thesis.

Issues and pull requests are welcome in public repositories. Start with CONTRIBUTING.md.

Report security issues through SECURITY.md, never a public issue.

_{heyrafiki.space · hello@heyrafiki.space}