REST API · DICOM · HL7/FHIR · Webhook

Build with Fractify
Clinical AI API

Integrate 97.9%-accurate medical imaging AI into your EMR, PACS, or telemedicine app. JSON responses in under 3 seconds. From $0.25/scan.

< 3s
Analysis latency
97.9%
Brain MRI accuracy
7
Imaging modalities
$0.25
Per scan (API)

Core API Endpoints

POST /api/v1/scan/analyse

Request Parameters

image_base64JPEG, PNG, or DICOM file encoded as base64
modalitychest_xray · bone_xray · ct_brain · ct_chest · brain_mri · dental · abdominal_ct
patient_idYour internal patient reference
clinical_contextOptional — patient history, symptoms, vitals

Response Fields

report_idUnique identifier for retrieval
findings[ ]Condition name, confidence %, severity, location
urgency1–5 urgency score (5 = immediate escalation)
heatmap_urlGrad-CAM AI detection heatmap image URL
processing_msAnalysis time — typically under 3,000 ms
GET /api/v1/report/{report_id}

URL Parameter

report_idFrom the /analyse response — e.g. rpt_7f3a9b2e

Returns

treatment_guidanceAI-generated clinical guidance text
fhir_diagnostic_reportFHIR R4 DiagnosticReport resource
differentials[ ]Ordered list of differential diagnoses
created_atISO 8601 timestamp of analysis
WEBHOOK POST {your_endpoint}

Triggers

analysis.completeFires on every completed analysis
analysis.criticalFires immediately on urgency 4–5 findings

Payload Fields

eventEvent type string
report_idReport reference for retrieval
urgency1–5 score
conditionPrimary finding name e.g. Tension Pneumothorax
patient_idYour patient reference passed at submission

Supported Modalities

chest_xray
18+ pathologies · Pneumonia, Pleural Effusion, Cardiomegaly, Pneumothorax · Critical: Tension Pneumothorax (urgency 5)
bone_xray
97.7% accuracy · Colles, Smith, scaphoid, metacarpal fractures · Emergency orthopaedics
ct_brain
6 hemorrhage subtypes · EDH, SDH, SAH, IPH, IVH · Midline shift · Critical: Acute ICH
brain_mri
97.9% accuracy · Glioma, Meningioma, Pituitary, Metastases · Critical: Acute Ischemic Stroke
ct_chest
Lung nodules (Fleischner) · Pulmonary Embolism · Critical: Aortic Dissection (urgency 5)
dental
OPG / Periapical / Bitewing · Caries at tooth level · Periodontal bone loss · Periapical pathology
abdominal_ct
Liver, spleen, kidneys, bowel · Appendicitis correlation · Free fluid / Free air

Integration Patterns

EMR / EHR Embed

Use the webhook to push AI findings directly into your patient record on scan upload. FHIR R4 DiagnosticReport output makes EMR attachment native.

PACS Integration

Submit DICOM files from your PACS worklist. Fractify returns structured reports and Grad-CAM heatmaps you can overlay in your PACS viewer. HL7 ORU message output supported.

Telemedicine Platforms

Doctors upload patient scans via mobile or web. The API returns AI pre-reads in under 3 seconds before the teleconsultation begins, enabling evidence-based remote consultations.

Radiology AI Triage

Run all incoming scans through the API for urgency scoring. Urgency 4–5 cases surface immediately for expedited radiologist review. Urgency 1–2 cases enter normal queue.

Authentication

# All requests require Authorization header
curl -X POST https://aiscan.fractify.net/api/v1/scan/analyse \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"image_base64":"...","modality":"chest_xray","patient_id":"PT-001"}'

API keys are issued per integration. Contact info@fractify.net to request access.

API Pricing

Volume Price per scan Notes
1–999 scans/month $0.25 Pay-as-you-go
1,000–4,999/month $0.18 Volume discount
5,000–9,999/month $0.12 Scale tier
10,000+/month Custom Enterprise contract

Developer FAQ

What does the API return for each scan?

A structured JSON diagnostic report with: primary findings and confidence scores, severity (Mild/Moderate/Severe/Critical), urgency score 1–5, differential diagnoses, treatment recommendations, and a Grad-CAM heatmap URL showing AI detection zones.

Does the API support DICOM files?

Yes. DICOM .dcm files are accepted. Submit 3+ DICOM files in one request to trigger series mode — the API automatically selects the optimal representative slice for analysis.

How does webhook delivery work?

Register a webhook URL in your account settings. Fractify POSTs a JSON payload to your endpoint on every analysis completion. For urgency 4–5 events, a separate critical alert webhook fires immediately with the critical condition name and recommended action.

Is the API HIPAA compliant?

The Fractify API uses HIPAA-ready architecture: TLS 1.3 in transit, AES-256 at rest, multi-tenant data isolation, immutable audit trail, and signed BAA available. Pixel data is not stored after analysis in cloud tier by default.

Can I deploy the API on my own infrastructure?

Yes. Fractify offers on-premise Docker deployment from $15,000 one-time. The API behaves identically on-premise as in cloud. Ideal for data-sovereign environments (government hospitals, military, high-compliance clinics).

Ready to integrate?

Contact the Fractify dev team to get your API key, discuss integration requirements, or arrange a live technical walkthrough.