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.
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
Replace each host below with the HTTPS bases your organization uses for Xenrad (FHIR, HL7 HTTP, and MPPS are separate URLs).
FHIR
curl -sS "https://fhir.integrations.xenrad-staging-app.xyz/fhir/metadata" | jq .
curl -sS "https://fhir.integrations.xenrad-staging-app.xyz/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.integrations.xenrad-staging-app.xyz/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.example.com/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.integrations.xenrad-staging-app.xyz" "3000"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.xenrad-staging-app.xyz" "11112"