Skip to main content
The Heyrafiki API connects Practitioner discovery, Bookings, Benefits, Sessions, Claims, remittance and Webhooks through one versioned REST interface. Use the Sandbox to build complete integrations.
Sandbox keys are issued to approved projects. Sandbox records are isolated from production and cannot be used for Care delivery, Benefits decisions or Claims.

Choose your path

Developers

Make the first request, handle errors and build against the Sandbox.

Payer teams

Map Coverage, Benefits, Claims, remittance, controls and acceptance evidence.

Care operations

Follow the operational path from discovery and Booking through covered Care.

Security and privacy

Review identity, purpose, Consent, scopes, data boundaries and audit behavior.

Public institutions

Review authority mappings, controlled exchange and synthetic pilot gates.

Researchers

Inspect reproducible evidence, prior-art boundaries and research limitations.

Start with the API

Authentication

Keys, headers and environments.

Errors

Status codes and the error envelope.

API overview

Map all 31 released operations before opening the endpoint reference.

Sandbox

Test records, failure cases and the request runner.
Last modified on August 20, 2026