API Reference/Diagnostic Reports

Diagnostic Reports

FHIR DiagnosticReport

FHIR R4 DiagnosticReport resources for lab panels, radiology reads, and AI-generated clinical reports.

The Diagnostic Report Object

FieldTypeDescription
idstringFHIR logical ID for the DiagnosticReport resource (e.g. dr_cbc_001)
resourceTypestringAlways "DiagnosticReport" per FHIR R4 spec
statusstringFHIR status: registered | partial | preliminary | final | amended
categoryCodeableConcept[]Report category: LAB, RAD, AI, PATH, etc.
codeCodeableConceptLOINC-coded report type (e.g. 58410-2 = CBC panel)
subjectReferenceReference to the Patient resource
issueddatetimeISO 8601 UTC datetime when the report was issued by the system
resultnullableReference[]References to Observation resources that are part of this report
conclusionnullablestringFree-text clinical interpretation or summary of the report

Endpoints

Returns FHIR DiagnosticReport resources for a patient.

Parameters

ParameterInTypeRequiredDescription
patiente.g. Patient/pat_demo_001querystringrequiredPatient ID
categorye.g. LABquerystringoptionalReport category (LAB|RAD|AI)

Request

curl "https://api.healthcloud.ai/v1/diagnostic-reports?patient=Patient/pat_demo_001&category=LAB" \
  -H "Authorization: Bearer hc_test_sk_demo_live_xxxxxx"

Response

Response200
{
  "resourceType": "Bundle",
  "type": "searchset",
  "entry": [
    {
      "resource": {
        "resourceType": "DiagnosticReport",
        "id": "dr_cbc_001",
        "status": "final",
        "category": [{ "coding": [{ "code": "LAB" }] }],
        "code": { "coding": [{ "system": "http://loinc.org", "code": "58410-2", "display": "CBC panel" }] },
        "subject": { "reference": "Patient/pat_demo_001" },
        "issued": "2026-03-15T10:30:00Z"
      }
    }
  ]
}

Related Resources