APIGrouper API

Your HIS. Our grouper.

Group episodes straight from your hospital information system with a secure API key. No separate web app, no re-typing, just the case group back where your team already works.

POST /v1/group
Request
curl -X POST https://api.casemix.com.my/v1/group \
  -H "Authorization: Bearer cx_live_••••••••" \
  -H "Content-Type: application/json" \
  -d '{
    "episode_id": "EP-2026-04817",
    "admission_date": "2026-09-28",
    "discharge_date": "2026-10-01",
    "principal_dx": "K35.8",
    "procedures": ["47.09"],
    "discharge_status": "home"
  }'
Response
{  "episode_id": "EP-2026-04817",  "status": "grouped",  "case_group": "K-4-18-I",  "description": "Appendicectomy procedures",  "severity": "I",  "warnings": []}
Trusted by leading hospitals and national schemes
How it fits

Grouping inside your HIS, not beside it.

Your system sends the episode, our grouper returns the case group, and your coders never leave the screen they already use.

01 · Your HIS

Episode is saved

After discharge, your system sends the clinical data.

Principal dxK35.8
Procedure47.09
02 · Grouper API

Grouped in moments

Validated and grouped with UNU-CBG® / MY-DRG® logic.

cx_live_••••••••
03 · Back in your HIS

Case group appears

The result is saved to the episode, ready for billing and reports.

Case groupK-4-18-I
StatusGrouped
Features

Simple to call, built for hospitals.

Clear error responses

When an episode can't be grouped, the response says exactly why, so your HIS can show the coder what to fix.

422 Unprocessable
{
  "status": "error",
  "code": "INVALID_DX",
  "field": "principal_dx",
  "message": "K358 is not a valid ICD-10 code"
}

API key per hospital

Each hospital gets its own key, which can be rotated or revoked at any time.

Real-time or bulk

Group one episode on discharge, or send a batch for month-end runs.

Same grouping logic

Identical results to our Web Grouper and Batch Grouper, every time.

Secure by design

HTTPS only, grouping logic only, and no data sent to AI.

Getting started

Live in three steps.

Our team works with your IT staff or HIS vendor from first call to go-live.

Talk to us

A short consultation to understand your HIS, volumes and workflow.

Test with a sandbox key

Your team integrates and tests with sample episodes, with our documentation and support.

Go live

Switch to your live key and start grouping inside your own system.

Three ways to group

Pick the one that fits your team.

Code Assist

One case at a time

For coders checking and verifying individual episodes in our Web Grouper.

Explore the Web Grouper
Batch Grouper

Files in bulk

Upload a month or a year of discharges and group them in one run.

Explore the Batch Grouper
Grouper API

From your own HIS

Automatic grouping inside the system your hospital already uses.

You are here
FAQ

Grouper API questions.

Ready to connect your HIS? Talk to our team.

Request API access

A hospital information system (or any system) that can make secure HTTPS requests, plus an API key from us. We start with a short consultation to scope your setup.

Usually your HIS vendor or IT team adds the API call. We provide documentation, sample requests and a sandbox key, and support them until you go live.

Yes. Send a single episode in real time after discharge, or a batch of episodes in one request for end-of-day or month-end runs.

No. The Grouper API runs grouping logic only and does not send data to AI. Send only the clinical fields grouping needs. See our Privacy Policy for details.

Keys are issued per hospital, only work over HTTPS, and can be rotated or revoked at any time. Keep them on your server, never in a browser or mobile app.

Pricing depends on your hospital and volume. After a consultation we send a quotation, with payment by invoice and bank transfer.