Fetching Observations for a Patient

Observations are entities that map to multiple different resources for a patient

Get v2 observations for a patient

get

Path parameters

patientIdForObservationstringRequiredPattern: [^\/#\?]+?

Query parameters

observationCodeNamestring[]Optional

observationGroupNamestring[]Optional

draftbooleanOptional

sourceTypestringOptional

sourceIdnumberOptional

observationCodeIdnumber[]Optional

observationGroupIdnumber[]Optional

organizationIdnumberOptional

startDateone ofOptional

string · dateOptional

or

string · date-timeOptional

patientIdstringOptional

isWearablebooleanOptional

personIdnumberOptional

endDateone ofOptional

string · dateOptional

or

string · date-timeOptional

skipnumberOptional

limitnumberOptional

sortstringOptional

Responses

200Success

application/json

get

/patients/{patientIdForObservation}/observations/v2

HTTPcURLJavaScriptPython

GET /patients/{patientIdForObservation}/observations/v2 HTTP/1.1
Host: 
Accept: */*

200Success

[
  {
    "id": 1,
    "patientId": "text",
    "name": "text",
    "date": "2025-12-11",
    "key": "text",
    "value": "text",
    "status": "text",
    "draft": true,
    "currentStatus": "text",
    "sourceType": null,
    "sourceId": 1,
    "patient": null,
    "observationCodeId": 1,
    "observationGroupId": 1,
    "observationGroup": null,
    "createdAt": "2025-12-11",
    "updatedAt": "2025-12-11"
  }
]

FHIR Resources Observations Map to

The FHIR (Fast Healthcare Interoperability Resources) standard defines a set of modular, extensible resources for exchanging healthcare information. Key FHIR resources involved in clinical documentation and analytics include:

Data Type	Corresponding Resource	Purpose/Description
Diagnoses (ICD-10)	Condition, Observation	Identifies patient conditions, chronic diseases, and diagnoses.
Procedures (CPT)	Procedure, Observation	Describes clinical services performed, office visits, surgeries, and other interventions.
Lab Tests (Regular Observations)	Observation	Diagnostic tests such as blood tests, urinalysis, imaging results, and other measurable clinical data.
Vital Signs	Observation	Common physiological measurements including blood pressure, heart rate, respiratory rate, temperature.
Diagnostic Measurements	Observation	Specialized clinical measurements such as imaging-derived results or pulmonary function test values.
Wearable/RPM Data	Observation	Patient-generated health data from wearables or home monitoring devices (e.g., steps, glucose, BP).
Social Determinants of Health (SDOH)	Observation	Quantified SDOH data like smoking status, BMI (39156-5), or nutrition indicators, often stored as observations.

Through these mappings, our single unified construct represents a wide variety of patient data, enabling interoperability and analytics across clinical, administrative, and patient-generated data sources.

While conditions and procedures have dedicated FHIR resources (Condition and Procedure), they may also appear as coded Observations for simplicity or workflow reasons in certain implementations. if needed, please reach out to the team for more information on dedicated Condition and Procedure endpoints

Examples

Get Patient Observations ICD Codes

GET /api/patients/:patientId/observations/v2

This example outlines how one can fetch ICD codes that are part of a patient profile

Headers

Name	Value
organization_code	{{ organization_code }}
api_key	{{ api_key }}

Query Params

Name	Value	Description
sort	desc	asc , desc
limit	1
isWearable	false
startDate	2024-12-16	Date
endDate	2024-12-18	Date
observationCodeName	Type2DiabetesMellitusWithoutComplications	Code for the Data we are fetching
observationGroupName	Diagnoses

Path Variables

	Value	Description
patientid	4089-b05f-6cd81c869749	FHIR resource id for the externalid

Response

200

{
    "id": "14e92c2e-22b0-4089-b05f-6cd81c869749",
    "patientId": "4089-b05f-6cd81c869749",
    "name": "Diabetes mellitus type 2",
    "key": null,
    "date": "2024-12-16T00:00:00.000Z",
    "value": "E11.9", 
    "sourceType": "EMR",
    "sourceId": 10049,
    "currentStatus": "active",
    "status": "confirmed",
    "draft": false,
    "createdAt": "2024-12-18T11:33:53.842Z",
    "updatedAt": "2024-12-18T11:35:32.456Z",
    "observationCodeId": 4000,  
    "observationGroupId": 700,  
    "observationCode": {
        "id": 4000,
        "organizationId": 118,
        "name": "Type2DiabetesMellitusWithoutComplications",
        "label": "ICD-10: E11.9",
        "attributes": {
            "codeType": "ICD-10",
            "category": "Endocrine",
            "billingEligible": true,
        },
        "sourceType": "EMR",
        "code": "E11.9",
        "unit": null,
        "entity": "BOTH",
        "isWearable": false,
        "active": true,
        "isTemplate": false,
        "templateId": null
    },
    "observationGroup": {
        "id": 700,
        "organizationId": 118,
        "name": "Diagnoses",
        "label": "PatientDiagnoses",
        "attributes": {
            "codeSystem": "ICD-10"
        }
    }
}

Get Patient Observations CPT codes

GET /api/patients/:patientId/observations/v2

Fetching Procedure Codes for a Patient

Headers

Name	Value
organization_code	{{ organization_code }}
api_key	{{ api_key }}

Query Params

Name	Value	Description
sort	desc	asc , desc
limit	1
isWearable	false
startDate	2024-12-16	Date
endDate	2024-12-18	Date
observationCodeName	Office/outpatientVisitEstablished	Code for the Data we are fetching
observationGroupName	Procedures

Path Variables

	Value	Description
patientid	4089-b05f-6cd81c869749	FHIR resource id for the externalid

Response

200

{
    "id": "b3d25935-f11b-4128-96dd-ab36f30b3d1d",
    "patientId": "4089-b05f-6cd81c869749",
    "name": "Office visit, established patient",
    "key": null,
    "date": "2024-12-16T00:00:00.000Z",
    "value": "99213",  
    "sourceType": "EMR",
    "sourceId": 10050,
    "currentStatus": "completed",
    "status": "billed",
    "draft": false,
    "createdAt": "2024-12-18T11:33:53.842Z",
    "updatedAt": "2024-12-18T11:35:32.456Z",
    "observationCodeId": 5002,  
    "observationGroupId": 871, 
    "observationCode": {
        "id": 5002,
        "organizationId": 118,
        "name": "Office/outpatientVisitEstablished",
        "label": "CPT: 99213",
        "attributes": {
            "codeType": "CPT",
            "category": "E/M Services",
            "billingEligible": true
        },
        "sourceType": "EMR",
        "code": "99213",
        "unit": null,
        "entity": "BOTH",
        "isWearable": false,
        "active": true,
        "isTemplate": false,
        "templateId": null
    },
    "observationGroup": {
        "id": 871,
        "organizationId": 118,
        "name": "Procedures",
        "label": "PatientProcedures",
        "attributes": {
            "codeSystem": "CPT"
        }
    }
}