Developers · technical partners

Connect to VCIL

Hospitals, labs, pharmacies, EHRs, wearables, insurers, research nodes, and companies authenticate with scoped keys. Demo secrets below are placeholders, never production PHI.

Request API access Join Health-X API docs →

VitaTwin Clinical Intelligence Layer

01 · Applications

Portals, clinician twin, assistants, partner apps

PatientClinicianHospitalsLabsPharmaciesResearch

02 · APIs · SDKs · MCP

Explainable, non-diagnostic intelligence

MindBiomarkersGenomicsForecastCopilotConsent

03 · Digital Twin graph

Longitudinal body · mind · biology · behavior

EventsWearablesLabsEHRConsent wallet

Authentication

Send Authorization: Bearer <key>. Keys are scoped (read twin, write labs, summarize, ingest FHIR). Rotate in Admin → API keys.

Munich Heart Clinic EHR
sandbox
vt_live_mhc_••••••••demo
dht.read · clinical.summarize · fhir.ingest
Quest partner lane
live
vt_live_quest_••••••••demo
labs.write · webhooks.inbound
Partner Pharmacy
sandbox
vt_live_rx_••••••••demo
meds.read · interactions.check
LMU research node
planned
vt_rsrch_••••••••demo
datasets.deidentified

Endpoint catalog

Sandbox and live badges are demo status only.

Method	Path	Purpose	Status
POST	/api/v1/clinical/mental/analyze.php	Mood, burnout, crisis safety	sandbox
POST	/api/v1/clinical/biomarkers/analyze.php	Lab interpretation	live
POST	/api/v1/clinical/genomics/analyze.php	PRS + PGx	sandbox
POST	/api/v1/clinical/summarize.php	Physician-ready twin summary	sandbox
POST	/api/v1/clinical/forecast.php	Preventive risk forecast	sandbox
POST	/api/v1/clinical/copilot.php	Clinician copilot	sandbox
POST	/api/v1/clinical/scribe.php	Visit scribe · coding · CDS demo	sandbox
GET	/api/v1/network/partners.php	Partner directory	live
POST	/api/v1/network/connect.php	Connection request	sandbox
POST	/api/v1/share/consent/grant.php	Grant scoped consent	sandbox
POST	/api/v1/share/consent/revoke.php	Revoke consent	sandbox
GET	/api/v1/integrations/status.php	Integration matrix	live
POST	/api/v1/webhooks/inbound.php	Lab / Rx / EHR inbound	live
GET	/api/mcp/index.php	MCP tool catalog	sandbox

Try it · mental

curl -s https://vitatwin.de/api/v1/clinical/mental/analyze.php \
  -H "Authorization: Bearer vt_live_mhc_••••••••demo" \
  -H "Content-Type: application/json" \
  -d '{"text":"tired this week","mood":"flat","stress":6,"sleepHours":5.5}'

Try it · forecast

curl -s https://vitatwin.de/api/v1/clinical/forecast.php \
  -H "Authorization: Bearer vt_live_mhc_••••••••demo" \
  -H "Content-Type: application/json" \
  -d '{"horizonDays":14}'

Try it · copilot

curl -s https://vitatwin.de/api/v1/clinical/copilot.php \
  -H "Authorization: Bearer vt_live_mhc_••••••••demo" \
  -H "Content-Type: application/json" \
  -d '{"patientId":"demo-alex-rivera"}'

safety_flag contract

none

Signals are within expected range. Continue wellness support. No crisis markers.

concerning

Elevated distress or dysregulation. Suggest trusted support and clinician review. Still non-diagnostic.

urgent

Crisis markers. Direct to emergency / local crisis lines. VitaTwin never provides harmful guidance.

Inbound webhooks

Labs/api/v1/webhooks/inbound.phplive
Pharmacies/api/v1/webhooks/inbound.phpsandbox
Hospitals / EHR/api/v1/webhooks/inbound.phpsandbox

Integration status

Hospitals & clinicssandbox
Labs (Quest / LabCorp / Mayo)live
Pharmaciessandbox
Wearablessandbox
Insurersplanned
Research institutionsplanned
Employers / companiessandbox

Building a partner integration?

Start with the endpoint catalog and MCP tools, then tell us your use case. We onboard consent-scoped twin access and PVS/KIS connectors through Health-X.

Email partners@vitatwin.de Partner join form MCP tools