Developers
Integration and API reference.
For HBYS vendors and hospital IT teams: the full provisioning API reference is below, so you can size the work before talking to us. Sandbox keys and live traffic are issued by us.
The hospital side initiates
The HBYS sends to Medonay in a single HTTPS request; Medonay never reaches into your system. Authentication is X-API-Key; every key binds to one hospital organization and carries an IP allowlist.
Two technical paths
Either implement the canonical API on this page directly in your product, or supply your own spec and Medonay writes the adapter. Both ways the work is once per vendor; after that each hospital is configuration only.
Sandbox and certification, free
We issue a demo-mode organization + API key for trials; you run end to end without touching production. Live traffic opens to integrations that pass our smoke scenarios. None of this is charged.
Versioning promise
The API is versioned in the path (/v1). Backwards-compatible additions land in place; breaking changes ship as a new version and the previous one keeps working for at least 12 months, announced.
For a sandbox key, write to us: leave a demo request
Hospital (HBYS) API reference
The reference below is produced from the live system's real surface; example bodies and the full error-code set included.
Ready to integrate?
Get your sandbox key, run end to end in the demo environment, go live with certification.