Endpoints reference
FHIR, HL7 HTTP, MLLP, MPPS, and DICOM SCP hostnames and ports for integrators.
Your Xenrad environment exposes separate HTTPS origins for FHIR R4, HL7 over HTTP, and MPPS, plus TCP endpoints for HL7 MLLP and DICOM C-STORE (DIMSE) when your team publishes them in this documentation site.
FHIR R4 baseResources under /fhir/… · metadata at /fhir/metadata
https://fhir.dev.xenrad.io/fhir
HL7 HTTPPOST /v2/ingest (v2.5.1), POST /v3/ingest (v3 XML)
https://hl7.dev.xenrad.io
MPPS HTTPPOST /ingest (JSON body, X-API-Key)
https://mpps.dev.xenrad.io
HL7 MLLP (TCP)Host and port for your interface engine (not HTTPS)
hl7.dev.xenrad.io:4420
DICOM C-STORE (SCP / DIMSE)Hostname and port for modalities; AE title is set per site in Xenrad
dicom.dev.xenrad.io:11112
HTTPS surfaces
Each integration has its own public base URL. Paths below are relative to that base (do not mix hosts).
| Surface | Typical paths | Interactive docs |
|---|---|---|
| FHIR R4 | /fhir/… (metadata at /fhir/metadata) | /api/documentation on the FHIR host |
| HL7 HTTP | POST /v2/ingest (v2.5.1 pipe-delimited body), POST /v3/ingest (v3 XML) | /api/documentation on the HL7 host |
| MPPS HTTP | POST /ingest (JSON body) | /api/documentation on the MPPS host |
OpenAPI JSON for each service: append /openapi.json to the documentation path (for example /api/documentation/openapi.json).
Example requests
FHIR
curl -sS "https://fhir.dev.xenrad.io/fhir/metadata" | jq .
curl -sS "https://fhir.dev.xenrad.io/fhir/Patient?name=smith" \
-H "Accept: application/fhir+json" \
-H "X-API-Key: YOUR_XENRAD_API_KEY"HL7 HTTP
curl -sS -X POST "https://hl7.dev.xenrad.io/v2/ingest" \
-H "X-API-Key: YOUR_XENRAD_API_KEY" \
-H "Content-Type: text/plain" \
--data-binary $'MSH|^~\\&|APP|FAC|XEN|FAC|20240101120000||ADT^A08|1|P|2.5.1\rPID|1||ID1||Doe^John||19800101|M\r'MPPS
curl -sS -X POST "https://mpps.dev.xenrad.io/ingest" \
-H "X-API-Key: YOUR_XENRAD_API_KEY" \
-H "Content-Type: application/json" \
-d '{"sop_instance_uid":"1.2.3.4.5","study_uid":"1.2.3.4.5.6","status":"IN PROGRESS"}'HL7 MLLP (TCP)
MLLP is not HTTP. Connect your interface engine to the hostname and port shown above or provided by your administrator.
nc -zv "hl7.dev.xenrad.io" "4420"DICOM C-STORE (DIMSE / SCP)
Modalities send studies to a hostname and TCP port (AE title is configured per site inside Xenrad).
nc -zv "dicom.dev.xenrad.io" "11112"