Organization Data API · v1

Push your clinical data
into MEDHAS.

One API key covers every clinic in your organization. Send patient visits, pharmacy stock, diet plans and lab results — they land in the same records MEDHAS clinicians work with, and flow straight into the Organization dashboard, trend charts and AI assistant. No separate reporting path to keep in sync.

VisitsPatient encounters — symptoms, diagnosis, medicines, vitals.2 endpoints InventoryPharmacy stock levels, batches and pricing per clinic.1 endpoint Diet plansCustom diet plans built from named food items.1 endpoint Lab resultsLab report values — blood work, vitals, any metric you track — for trend charts and research.2 endpoints DravyasAyurvedic drugs and the classical combinations built from them — shared across your whole organization, optionally dispensed straight into a clinic’s inventory.4 endpoints

Base URLhttps://medhas.co.in/api/external/v1/organizations

Authentication

Every request carries your organization’s API key as a bearer token. There is no separate login step and no token exchange.

Header on every request

Authorization: Bearer <YOUR_API_KEY>

Use your key on this pageFills every code sample below and unlocks the live console.

Kept in this browser tab only (session storage) and sent nowhere except the MEDHAS endpoint you invoke. It is cleared when you close the tab.

Treat the key like a password.

It authorizes writes to every clinic in your organization and is shown only once when generated. Keep it in a server-side secret store, never in client code or version control. If it leaks, ask your MEDHAS contact to revoke it — revocation takes effect immediately.

Status	Meaning
200 Accepted	Check the per-record status field — a batch can succeed overall and still contain individual record errors.
400 Bad request	Malformed JSON, an empty array, or a batch over the 500-record limit.
401 Unauthorized	Authorization header missing, key unrecognized, or key revoked.
500 Server error	Something failed on our side. Safe to retry — idempotency keys prevent duplicates.

Quickstart

The shortest path from a fresh API key to data appearing in MEDHAS.

1
Get your API keyMEDHAS provisions one per organization and shares it with you out of band.
2
Choose a stable clinic codeYour own identifier per clinic — a branch code works well. That value becomes externalClinicId; the format is entirely yours.
3
Send your first visitInclude clinicName the first time a new code appears and the clinic is created for you. After that the code alone is enough.
4
Give every record an external idWith externalVisitId set, resending is safe — you get updated back instead of a duplicate.
5
Read results per recordBatches return one result per item. Inspect each status rather than assuming the whole batch shared one outcome.

Clinics create themselves.

There is no setup call and no clinic registry to sync first. The first record you send for an unknown externalClinicId creates the clinic from the clinicName on that record. If an unknown code arrives with no name, that single record is rejected with a clear message — it never guesses which clinic you meant.

Severity scale

MEDHAS scores symptom severity on a fixed 0–10 scale internally. Send ratings on whatever scale your system already uses and declare it — the conversion is linear and lossless.

Your scale tops out at

You send ratingRaw = 4

Stored severity7.5/10

normalized = (ratingRaw − 1) ÷ (ratingScale − 1) × 10Your raw value is stored alongside it, so nothing about your original scale is lost.

Visits

Patient encounters — symptoms, diagnosis, medicines, vitals.

POST/api/external/v1/organizations/visits

Create or update a visit

Records one patient encounter — identity, rated symptoms, diagnosis, medicines, vitals and billing in a single call.

idempotent on externalVisitId

Routing

Field	Type	Description
`externalClinicId`required	string	Your own clinic code. You choose the format — just keep it stable.
`clinicName`	string	Required only the first time a code appears. Auto-creates the clinic.
`clinicCity`	string	Used only when auto-creating.
`clinicState`	string	Used only when auto-creating.

Visit

Field	Type	Description
`externalVisitId`	string	Your visit id. Re-sending the same id updates that visit instead of duplicating it.
`visitDate`required	date	YYYY-MM-DD.
`visitTime`	string	HH:MM, 24-hour. Defaults to 09:00.
`nextVisitDate`	date	YYYY-MM-DD.
`treatmentDays`	number	Overall course length.
`medicineDays`	number	Medicine course length, if tracked separately.
`externalDoctorId`	string	Your prescriber id. First sighting creates an attribution record so per-doctor reporting includes your data.
`doctorName`	string	Used only when creating that doctor record.
`notes`	string	Free text.

patient

The identity key is externalId — sending it again updates the same patient rather than creating a second one.

Field	Type	Description
`patient.externalId`required	string	Your patient id.
`patient.name`	string	—
`patient.sex`	string	M / F / O.
`patient.ageYears`	number	—
`patient.dob`	date	YYYY-MM-DD.
`patient.mobile`	string	—
`patient.whatsapp`	string	—
`patient.email`	string	—
`patient.address`	object	Free-form; stored as sent.
`patient.occupation`	string	—

symptoms[]

One entry per condition. Rate each symptom on your own scale and declare the scale — MEDHAS normalizes it.

Field	Type	Description
`symptoms[].name`required	string	Condition name. No fixed vocabulary required.
`symptoms[].diseaseId`	string	An NAMC code if you have one — improves catalog matching.
`symptoms[].symptoms[].label`required	string	Symptom name, free text.
`symptoms[].symptoms[].ratingRaw`required	number	Severity on your scale.
`symptoms[].symptoms[].ratingScale`	number	Top of your scale, e.g. 5. Defaults to 5.

diseases[]

Diagnosed conditions for this visit, separate from the rated symptom list.

Field	Type	Description
`diseases[].name`required	string	—
`diseases[].diseaseId`	string	—
`diseases[].status`	string	new / ongoing / resolved. Defaults to ongoing.

medicines[]

Matched by name against the organization product catalog for adoption reporting — consistent naming improves accuracy.

Field	Type	Description
`medicines[].medicineName`required	string	—
`medicines[].medicineType`	string	—
`medicines[].doseMorning`	number	—
`medicines[].doseAfternoon`	number	—
`medicines[].doseNight`	number	—
`medicines[].quantity`	number	—
`medicines[].days`	number	Course length for this line.
`medicines[].instruction`	string	e.g. "after food".
`medicines[].externalInventoryItemId`	string	Links the line to stock you registered via /inventory/batch.

Clinical objects

Field	Type	Description
`diagnosis`	object	{ ayurved, modern, modernSystem, icdCode } — all optional strings.
`doshaBalance`	object	{ vata, pitta, kapha } — integers 0–10.
`investigations`	array	[{ name, result? }] — tests ordered or reviewed at the visit, up to 30.
`labResults`	array	[{ name, value, unit?, ref?, flag? (low\|high) }] — results recorded at the visit, up to 80.
`dietAdvice`	array	Diet lines for the patient (strings), up to 40.
`exercises`	array	Yoga / exercise lines (strings), up to 40.
`vitals`	object	{ bpSystolic, bpDiastolic, temperature, temperatureUnit, height, heightUnit, weight, weightUnit, spo2, pulse }.
`billing`	object	{ consultingFee, medicineFee, paidAmount, paymentMode }.

curl -X POST 'https://medhas.co.in/api/external/v1/organizations/visits' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"externalClinicId":"PUNE-07","clinicName":"Pune Koregaon Park Clinic","clinicCity":"Pune","clinicState":"Maharashtra","externalVisitId":"V-88213","externalDoctorId":"D-42","doctorName":"Dr. Aditi Rao","visitDate":"2026-01-15","patient":{"externalId":"P-10234","name":"Ravi Kumar","sex":"M","ageYears":45},"symptoms":[{"name":"Type 2 Diabetes","symptoms":[{"label":"Frequent urination","ratingRaw":4,"ratingScale":5},{"label":"Excessive thirst","ratingRaw":3,"ratingScale":5}]}],"diseases":[{"name":"Type 2 Diabetes","status":"ongoing"}],"medicines":[{"medicineName":"Nishamalaki Churna","doseMorning":1,"doseNight":1,"quantity":60,"days":30}],"diagnosis":{"ayurved":"Madhumeha","modern":"Type 2 Diabetes Mellitus"},"vitals":{"bpSystolic":130,"bpDiastolic":85,"weight":78,"weightUnit":"kg"},"billing":{"consultingFee":500,"medicineFee":800,"paidAmount":1300,"paymentMode":"cash"}}'

Response · 200

{
  "externalVisitId": "V-88213",
  "status": "created",
  "clinicId": "66f1a2b3c4d5e6f7a8b9c0d1",
  "patientId": "66f1a2b3c4d5e6f7a8b9c0d2"
}

Try itAdd your API key at the top of the page to enable this

Request body

{
  "externalClinicId": "PUNE-07",
  "clinicName": "Pune Koregaon Park Clinic",
  "clinicCity": "Pune",
  "clinicState": "Maharashtra",
  "externalVisitId": "V-88213",
  "externalDoctorId": "D-42",
  "doctorName": "Dr. Aditi Rao",
  "visitDate": "2026-01-15",
  "patient": {
    "externalId": "P-10234",
    "name": "Ravi Kumar",
    "sex": "M",
    "ageYears": 45
  },
  "symptoms": [
    {
      "name": "Type 2 Diabetes",
      "symptoms": [
        {
          "label": "Frequent urination",
          "ratingRaw": 4,
          "ratingScale": 5
        },
        {
          "label": "Excessive thirst",
          "ratingRaw": 3,
          "ratingScale": 5
        }
      ]
    }
  ],
  "diseases": [
    {
      "name": "Type 2 Diabetes",
      "status": "ongoing"
    }
  ],
  "medicines": [
    {
      "medicineName": "Nishamalaki Churna",
      "doseMorning": 1,
      "doseNight": 1,
      "quantity": 60,
      "days": 30
    }
  ],
  "diagnosis": {
    "ayurved": "Madhumeha",
    "modern": "Type 2 Diabetes Mellitus"
  },
  "vitals": {
    "bpSystolic": 130,
    "bpDiastolic": 85,
    "weight": 78,
    "weightUnit": "kg"
  },
  "billing": {
    "consultingFee": 500,
    "medicineFee": 800,
    "paidAmount": 1300,
    "paymentMode": "cash"
  }
}

/api/external/v1/organizations/visits

POST/api/external/v1/organizations/visits/batch

Send a batch of visits

Up to 500 visits per request. Each record is processed independently — one bad record never fails the rest.

max 500 per requestidempotent on externalVisitId

Body

Field	Type	Description
`visits[]`required	array	Each element uses exactly the same shape as the single-visit endpoint above.

curl -X POST 'https://medhas.co.in/api/external/v1/organizations/visits/batch' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"visits":[{"externalClinicId":"PUNE-07","externalVisitId":"V-1","visitDate":"2026-01-15","patient":{"externalId":"P-1","name":"Meera Nair"},"medicines":[{"medicineName":"Triphala Churna","quantity":30}]},{"externalClinicId":"PUNE-07","externalVisitId":"V-2","visitDate":"2026-01-15","patient":{"externalId":"P-2","name":"Arjun Shetty"},"diagnosis":{"modern":"Hypertension"}}]}'

Response · 200

{
  "results": [
    {
      "externalVisitId": "V-1",
      "status": "created",
      "clinicId": "…",
      "patientId": "…"
    },
    {
      "externalVisitId": "V-2",
      "status": "error",
      "error": "visitDate is required (YYYY-MM-DD)."
    }
  ],
  "summary": {
    "received": 2,
    "created": 1,
    "error": 1
  }
}

Try itAdd your API key at the top of the page to enable this

Request body

/api/external/v1/organizations/visits/batch

Inventory

Pharmacy stock levels, batches and pricing per clinic.

POST/api/external/v1/organizations/inventory/batch

Sync pharmacy stock

Registers or updates stock items for a clinic. Up to 500 items per request.

max 500 per requestidempotent on externalItemId

Routing

Field	Type	Description
`items[].externalClinicId`required	string	Your own clinic code. You choose the format — just keep it stable.
`items[].clinicName`	string	Required only the first time a code appears. Auto-creates the clinic.
`items[].clinicCity`	string	Used only when auto-creating.
`items[].clinicState`	string	Used only when auto-creating.

Item

Field	Type	Description
`items[].externalItemId`	string	Your stock id. Re-sending updates the same item.
`items[].medicineName`required	string	Matched against the organization product catalog.
`items[].medicineType`	string	—
`items[].company`	string	—
`items[].alternateName`	string	—
`items[].batchNo`	string	—
`items[].mfgDate`	date	—
`items[].expDate`	date	—
`items[].packagingSize`	string	—
`items[].packagingType`	string	—
`items[].stock`	number	Defaults to 0 when omitted.
`items[].minimumStock`	number	Drives low-stock alerts.
`items[].rate`	number	Cost price.
`items[].sellRate`	number	Selling price.
`items[].gst`	number	—
`items[].hsn`	string	—
`items[].barcodeNo`	string	—
`items[].medicineCode`	string	—
`items[].supplierName`	string	—
`items[].billNo`	string	—
`items[].billDate`	date	—
`items[].otcProduct`	boolean	—
`items[].withBill`	boolean	—
`items[].exclusiveGst`	boolean	—
`items[].notes`	string	—

curl -X POST 'https://medhas.co.in/api/external/v1/organizations/inventory/batch' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"items":[{"externalClinicId":"PUNE-07","externalItemId":"SKU-4471","medicineName":"Nishamalaki Churna","stock":120,"minimumStock":15,"sellRate":180,"expDate":"2028-06-30"}]}'

Response · 200

{
  "results": [
    {
      "externalItemId": "SKU-4471",
      "status": "created",
      "id": "66f1a2b3c4d5e6f7a8b9c0d3"
    }
  ],
  "summary": {
    "received": 1,
    "created": 1
  }
}

Try itAdd your API key at the top of the page to enable this

Request body

/api/external/v1/organizations/inventory/batch

Diet plans

Custom diet plans built from named food items.

POST/api/external/v1/organizations/diet-plans

Create or update a diet plan

Food items MEDHAS has not seen for this clinic are registered automatically — you never need to match an existing catalog.

idempotent on externalPlanId

Routing

Field	Type	Description
`externalClinicId`required	string	Your own clinic code. You choose the format — just keep it stable.
`clinicName`	string	Required only the first time a code appears. Auto-creates the clinic.
`clinicCity`	string	Used only when auto-creating.
`clinicState`	string	Used only when auto-creating.

Plan

Field	Type	Description
`externalPlanId`	string	Re-sending updates the same plan.
`name`required	string	Plan name.
`note`	string	—

items[]

Only name is required. Every classification field falls back to a sane default rather than rejecting the item.

Field	Type	Description
`items[].name`required	string	Food name, free text.
`items[].sanskrit`	string	—
`items[].group`	enum	grains · legumes · vegetables · fruits · spices · dairy · oils · nuts_seeds · sweeteners · beverages · animal · condiments · prepared. Anything else falls back to prepared.
`items[].virya`	enum	heating / cooling / neutral.
`items[].guna`	enum	sattvic / rajasic / tamasic.
`items[].dosha`	object	{ vata, pitta, kapha }, each favor / moderate / avoid / neutral.

curl -X POST 'https://medhas.co.in/api/external/v1/organizations/diet-plans' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"externalClinicId":"PUNE-07","externalPlanId":"DIET-118","name":"Diabetic Management Plan A","items":[{"name":"Bitter Gourd Soup","group":"prepared"},{"name":"Steamed Millets","group":"grains"}]}'

Response · 200

{
  "externalPlanId": "DIET-118",
  "status": "created",
  "id": "66f1a2b3c4d5e6f7a8b9c0d4"
}

Try itAdd your API key at the top of the page to enable this

Request body

/api/external/v1/organizations/diet-plans

Lab results

Lab report values — blood work, vitals, any metric you track — for trend charts and research.

POST/api/external/v1/organizations/lab-results

Send a lab report

Records one report’s worth of lab values for a patient — the same destination as a doctor typing results into the app, so they show up in trend charts, research and the AI assistant immediately.

idempotent on clinic + patient + reportDate

Routing

Field	Type	Description
`externalClinicId`required	string	Your own clinic code. You choose the format — just keep it stable.
`clinicName`	string	Required only the first time a code appears. Auto-creates the clinic.
`clinicCity`	string	Used only when auto-creating.
`clinicState`	string	Used only when auto-creating.

Report

Field	Type	Description
`reportDate`required	date	YYYY-MM-DD. Resending this date merges into the same report instead of creating a duplicate.

patient

The identity key is externalId — sending it again updates the same patient rather than creating a second one.

Field	Type	Description
`patient.externalId`required	string	Your patient id.
`patient.name`	string	—
`patient.sex`	string	M / F / O.
`patient.ageYears`	number	—
`patient.dob`	date	YYYY-MM-DD.
`patient.mobile`	string	—

values

An object keyed by metric name — letters, digits and underscore only. Recognized keys (hba1c, glucose_fasting, systolic_bp, diastolic_bp, hemoglobin, and more) get a friendly label and unit automatically; any other key is stored and labeled as sent. Each value is a number or short text (under 200 characters). 1–100 entries per report.

Field	Type	Description
`values.<metricKey>`required	number \| string	One entry per lab value on this report, e.g. values.hba1c, values.systolic_bp.

curl -X POST 'https://medhas.co.in/api/external/v1/organizations/lab-results' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"externalClinicId":"PUNE-07","reportDate":"2026-01-15","patient":{"externalId":"P-10234","name":"Ravi Kumar"},"values":{"hba1c":7.2,"glucose_fasting":118,"systolic_bp":130,"diastolic_bp":85,"notes":"Sample slightly hemolyzed"}}'

Response · 200

{
  "status": "created",
  "clinicId": "66f1a2b3c4d5e6f7a8b9c0d1",
  "patientId": "66f1a2b3c4d5e6f7a8b9c0d2",
  "reportDate": "2026-01-15",
  "metricCount": 5
}

Try itAdd your API key at the top of the page to enable this

Request body

/api/external/v1/organizations/lab-results

POST/api/external/v1/organizations/lab-results/batch

Send a batch of lab reports

Up to 500 reports per request. Each record is processed independently — one bad record never fails the rest.

max 500 per requestidempotent on clinic + patient + reportDate

Body

Field	Type	Description
`reports[]`required	array	Each element uses exactly the same shape as the single-report endpoint above.

curl -X POST 'https://medhas.co.in/api/external/v1/organizations/lab-results/batch' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"reports":[{"externalClinicId":"PUNE-07","reportDate":"2026-01-15","patient":{"externalId":"P-1","name":"Meera Nair"},"values":{"hemoglobin":12.4,"wbc":6400}},{"externalClinicId":"PUNE-07","reportDate":"2026-01-15","patient":{"externalId":"P-2","name":"Arjun Shetty"},"values":{"systolic_bp":142,"diastolic_bp":92}}]}'

Response · 200

{
  "results": [
    {
      "status": "created",
      "clinicId": "…",
      "patientId": "…",
      "reportDate": "2026-01-15",
      "metricCount": 2
    },
    {
      "status": "created",
      "clinicId": "…",
      "patientId": "…",
      "reportDate": "2026-01-15",
      "metricCount": 2
    }
  ],
  "summary": {
    "received": 2,
    "created": 2
  }
}

Try itAdd your API key at the top of the page to enable this

Request body

/api/external/v1/organizations/lab-results/batch

Dravyas

Ayurvedic drugs and the classical combinations built from them — shared across your whole organization, optionally dispensed straight into a clinic’s inventory.

POST/api/external/v1/organizations/moolikas

Create or update a herb (Dravya)

Registers one raw herb into your organization’s shared Dravya catalog — the ingredient list combinations are built from. Unlike visits/inventory/diet/lab-results, this is organization-scoped, not per-clinic: no externalClinicId routing is needed, and every clinic in the org sees and can edit the same catalog.

idempotent on externalHerbId (falls back to name)

Herb

Field	Type	Description
`externalHerbId`	string	Your herb id. Re-sending the same id updates that herb. Omit it and re-sending the same name updates instead.
`name`required	string	—
`botanicalName`	string	—
`sanskrit`	string	—
`partUsed`	string	Root, leaf, bark, seed, etc.
`rasa`	array	Taste(s): madhura, amla, lavana, katu, tikta, kashaya.
`guna`	string	Property, e.g. laghu, snigdha.
`dosha`	object	{ vata, pitta, kapha }, each increase / decrease / neutral.
`virya`	string	—
`vipaka`	string	—
`karma`	string	—
`uses`	string	—
`dose`	string	—
`kind`	string	plant / mineral / animal / salt / sugar / liquid / formulation. Defaults to plant.
`englishName`	string	—
`aliases`	array	Other names and spellings; search matches them.
`processedForm`	string	e.g. bhasma, kshara, sattva.
`varieties`	array	—
`substitutes`	array	—
`requiresShodhana`	boolean	True when it must be purified before use.
`source`	string	Supplier or origin.
`notes`	string	—

curl -X POST 'https://medhas.co.in/api/external/v1/organizations/moolikas' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"externalHerbId":"HERB-ASH-01","name":"Ashwagandha","botanicalName":"Withania somnifera","sanskrit":"Ashwagandha","partUsed":"Root","rasa":["tikta","kashaya"],"dosha":{"vata":"decrease","kapha":"increase"}}'

Response · 200

{
  "externalHerbId": "HERB-ASH-01",
  "status": "created",
  "id": "66f1a2b3c4d5e6f7a8b9c0d5"
}

Try itAdd your API key at the top of the page to enable this

Request body

/api/external/v1/organizations/moolikas

POST/api/external/v1/organizations/moolikas/batch

Sync a batch of herbs

Up to 500 herbs per request. Each record is processed independently — one bad record never fails the rest.

max 500 per requestidempotent on externalHerbId (falls back to name)

Body

Field	Type	Description
`herbs[]`required	array	Each element uses exactly the same shape as the single-herb endpoint above.

curl -X POST 'https://medhas.co.in/api/external/v1/organizations/moolikas/batch' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"herbs":[{"name":"Tulsi","botanicalName":"Ocimum sanctum"},{"name":"Guduchi","botanicalName":"Tinospora cordifolia"}]}'

Response · 200

{
  "results": [
    {
      "status": "created",
      "id": "…"
    },
    {
      "status": "created",
      "id": "…"
    }
  ],
  "summary": {
    "received": 2,
    "created": 2
  }
}

Try itAdd your API key at the top of the page to enable this

Request body

/api/external/v1/organizations/moolikas/batch

POST/api/external/v1/organizations/moolika-combinations

Create or update a herb combination

Builds a formulation (Kashayam, Choornam, Rasayana, ...) from named herbs in your organization’s shared Dravya catalog — an herb name not already in it is auto-registered first. Also organization-scoped, not per-clinic. Set autoDispense (plus externalClinicId/clinicName) to also push the result into that clinic’s medicine inventory in the same call.

idempotent on externalCombinationId

Combination

Field	Type	Description
`externalCombinationId`	string	Your combination id. Re-sending the same id updates that combination.
`name`required	string	—
`preparationType`	string	kashayam / choornam / kwath / rasayana / arishta / ghrita / taila / other. Defaults to other.
`indication`	string	—
`dosage`	string	—
`anupana`	string	Vehicle it’s taken with, e.g. warm water, honey.
`category`	string	Formulary group id, e.g. asava-arishta, taila, churna, vati, bhasma.
`route`	string	internal / external / both.
`method`	string	How it is prepared.
`preservation`	string	How long it keeps and how it is stored.
`aliases`	array	—
`diseases`	array	Disease terms it is indexed under.
`notes`	string	—
`autoDispense`	boolean	When true, immediately adds the saved combination to a clinic’s medicine inventory as a stock item.

Dispensing (only used with autoDispense)

Field	Type	Description
`externalClinicId`	string	Your own clinic code. You choose the format — just keep it stable. Only read when autoDispense is true.
`clinicName`	string	Required only the first time a code appears. Auto-creates the clinic. Only read when autoDispense is true.
`clinicCity`	string	Used only when auto-creating. Only read when autoDispense is true.
`clinicState`	string	Used only when auto-creating. Only read when autoDispense is true.

herbs[]

Referenced by name, not id — a name not already in the catalog is registered automatically.

Field	Type	Description
`herbs[].name`required	string	—
`herbs[].quantity`	number	Defaults to 1.
`herbs[].unit`	string	e.g. part, g, kg, ml, l, q.s. Defaults to "part".
`herbs[].role`	string	main / liquid / prakshepa / bhavana / pralepana / dhupana / other. Defaults to main.
`herbs[].part`	string	Part of the plant, e.g. Root.

curl -X POST 'https://medhas.co.in/api/external/v1/organizations/moolika-combinations' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"externalClinicId":"PUNE-07","externalCombinationId":"COMBO-DASHA-01","name":"Dashamoola Kashayam","preparationType":"kashayam","indication":"Vata disorders, postpartum care","dosage":"15ml twice daily before food","anupana":"Warm water","herbs":[{"name":"Bilva","quantity":1,"unit":"part"},{"name":"Shyonaka","quantity":1,"unit":"part"}],"autoDispense":true}'

Response · 200

{
  "externalCombinationId": "COMBO-DASHA-01",
  "status": "created",
  "id": "66f1a2b3c4d5e6f7a8b9c0d6",
  "inventoryItemId": "66f1a2b3c4d5e6f7a8b9c0d7"
}

Try itAdd your API key at the top of the page to enable this

Request body

/api/external/v1/organizations/moolika-combinations

POST/api/external/v1/organizations/moolika-combinations/batch

Sync a batch of herb combinations

Up to 500 combinations per request. Each record is processed independently — one bad record never fails the rest.

max 500 per requestidempotent on externalCombinationId

Body

Field	Type	Description
`combinations[]`required	array	Each element uses exactly the same shape as the single-combination endpoint above.

curl -X POST 'https://medhas.co.in/api/external/v1/organizations/moolika-combinations/batch' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"combinations":[{"name":"Triphala Choornam","preparationType":"choornam","herbs":[{"name":"Amalaki"},{"name":"Bibhitaki"},{"name":"Haritaki"}]}]}'

Response · 200

{
  "results": [
    {
      "status": "created",
      "id": "…",
      "inventoryItemId": null
    }
  ],
  "summary": {
    "received": 1,
    "created": 1
  }
}

Try itAdd your API key at the top of the page to enable this

Request body

/api/external/v1/organizations/moolika-combinations/batch

Responses & retries

Ingestion endpoints report an outcome per record, never a single pass/fail for a whole batch.

Record status	Meaning
created	A new record was inserted.
updated	An existing record with the same external id was found and updated in place.
error	This one record was rejected — read its error string. Other records in the batch are unaffected.

Retrying safely

Every endpoint is idempotent when you supply an external id — externalVisitId,externalItemId or externalPlanId. If a request times out or you cannot tell whether it landed, send it again unchanged: you will get updated rather than a duplicate. Records sent without an external id are always inserted as new, so set one wherever you can. Lab results have no separate id to set — the report date itself is the key, so resending the same clinic/patient/date always merges into that one report rather than duplicating it.

What happens to your data

Symptom severity is normalized to 0–10 and feeds trend charts and the AI assistant exactly like an assessment typed in at the clinic.
Medicine names are matched against your organization’s product catalog for adoption reporting. Matching is exact on name, so consistent naming between your visit and inventory records improves accuracy.
Doctors identified by externalDoctorId get an attribution record — not a login — so per-prescriber reporting includes your data without provisioning accounts.
Auto-created clinics can be renamed or remapped later by your organization admin without affecting data already ingested.
Lab values land in the same place a doctor typing results into the app writes to, so they appear on the patient’s report history and trend charts immediately — recognized metric keys (e.g. hba1c, systolic_bp) get a proper label and unit; unrecognized ones are still stored, labeled as sent.

Push your clinical datainto MEDHAS.

Authentication

Quickstart

Severity scale

Visits

Routing

Visit

patient

symptoms[]

diseases[]

medicines[]

Clinical objects

Body

Inventory

Routing

Item

Diet plans

Routing

Plan

items[]

Lab results

Routing

Report

patient

values

Body

Dravyas

Herb

Body

Combination

Dispensing (only used with autoDispense)

herbs[]

Body

Responses & retries

Retrying safely

What happens to your data

Push your clinical data
into MEDHAS.