API

API Reference

RESTful API for clinical inference at scale. 47ms average latency, 4.2M inferences/hour, HIPAA and GDPR compliant.

BASE URL
https://api.neuralcareai.tech
Endpoints
POSTInfer POSTBatch Infer GETModels GETPatient History WHWebhooks Rate Limits Error Codes

Authentication

Bearer Token

All requests require a Bearer token in the Authorization header. API keys are prefixed nc_live_ for production and nc_test_ for sandbox.

Authorization: Bearer nc_live_xxxxxxxxxxxxxxxxxxxx
POST /v1/infer

Run a single-patient inference. Returns a risk score, contributing signals, and model explainability tokens. GPU-accelerated — average latency 47ms.

Request Body
patient_id required String. Your institutional patient identifier.
model required String. Model ID — e.g. oncology-v4, cardiology-v3, sepsis-v5.
fhir_bundle optional FHIR R4 Bundle object. If omitted, NeuralCare fetches from your connected EHR.
Response Example
{
  "patient_id": "pt-928374",
  "model": "oncology-v4.2.1",
  "risk_score": 0.847,
  "risk_level": "HIGH",
  "latency_ms": 43,
  "signals": [
    { "feature": "CBC_trend_3m", "weight": 0.31 },
    { "feature": "fatigue_icd_pattern", "weight": 0.24 }
  ],
  "inference_id": "inf_01JXQZMK8B2P4RDVTG9NW",
  "timestamp": "2025-05-18T09:24:11.047Z"
}
GET /v1/models

List all available inference models and their current versions, performance metrics, and supported clinical domains.

{
  "models": [
    { "id": "oncology-v4", "auc": 0.974, "status": "stable" },
    { "id": "cardiology-v3", "auc": 0.961, "status": "stable" },
    { "id": "sepsis-v5", "auc": 0.948, "status": "stable" },
    { "id": "metabolic-v2", "auc": 0.932, "status": "beta" }
  ]
}

Rate Limits

1,000
req/min — Starter
70,000
req/min — Enterprise
Unlimited
On-prem deployments

Error Codes

400 invalid_request Missing required field or malformed FHIR bundle.
401 unauthorized Invalid or expired API key.
429 rate_limit_exceeded Request rate exceeds your plan limit. Retry after X-RateLimit-Reset.
503 model_unavailable Requested model is temporarily offline. Check status.neuralcareai.tech.