GET api/v1/{EMRSystem}/Population/Observations

Returns all Observations (Flowsheets or Clinical Interventions) of all statuses for all patients for a given date range and filtered, optionally, by Locations (facilities) or Categories (list) or Components (list). Observations are used to document interventions during patient visits (e.g. vital signs, pulse oximetry, pain scale, etc.).

Status: Released

URI Parameters

NameDescriptionTypeAdditional information
EMRSystem

The emr system.

EMRSystem

None.
LocationList

Gets or sets the location list.

string

None.
CategoryList

Gets or sets the category list.

string

None.
ComponentList

Gets or sets the component list.

string

None.
IncludeComments

Gets or sets a value to retrieve bservation comments.

boolean

None.
UserId

Identifier of the user initiating the request.

string

Required
FromDateTime

Gets or sets from date time.

datetime

Required if EMRSystem = Cerner, or Epic, or Meditech
ToDateTime

Gets or sets to date time.

datetime

None.

Header Parameters

NameDescriptionTypeAdditional information
LoginId

Gets or sets the login identifier. This Login Id will be encrypted and passed in Sansoro specific Http Request Headers.

string

Required if EMRSystem = Allscripts, or Athena, or Cerner, or Meditech, or Sandbox
Password

Gets or sets the password. This Password will be encrypted and passed in Sansoro specific Http Request Headers.

string

Data type: Password

Required if EMRSystem = Allscripts, or Athena, or Cerner, or Meditech, or Sandbox
EmrInstance

Gets or sets the emr instance. This emr instance info will be encrypted and passed in Sansoro specific Http Request Headers.

string

None.
ApplicationName

Gets or sets the requesting application name. This requesting application name will be encrypted and passed in Sansoro specific Http Request Headers.

string

Required if using application keys
ApplicationKey

Gets or sets the requesting application key. This requesting application key will be encrypted and passed in Sansoro specific Http Request Headers.

string

Data type: Password

Required if using application keys
AuthorizationToken

Gets or sets the custom authorization token. This requesting authorization token will be encrypted and passed in Sansoro specific Http Request Headers.

string

None.
RequestVerboseLogging

Enables verbose logging for a single request. When "true", verbose logging will occur. When "false", the configuration setting will be respected. This value will be passed in Sansoro specific Http Request Headers.

boolean

None.

Response Information

Collection of UdmPopulationObservationResponse
NameDescriptionTypeAdditional information
ObservationId

Gets or sets the observation identifier.

string

None.
CategoryId

Gets or sets the Category identifier.

string

None.
CategoryDesc

Gets or sets the Category description.

string

None.
OrderId

Gets or sets the order identifier.

string

None.
ComponentId

Gets or sets the component identifier.

string

None.
ComponentDesc

Gets or sets the component desc.

string

None.
ObservationType

Gets or sets the type of the observation.

string

None.
ObservationStatus

Gets or sets the observation status.

string

None.
ObservationValue

Gets or sets the observation value.

string

None.
ObservationUnits

Gets or sets the observation units.

string

None.
Normalcy

Gets or sets the normalcy.

string

None.
EffectiveDateTime

Gets or sets the effective date time.

datetime

None.
ObservedDateTime

Gets or sets the observed date time.

datetime

None.
NormalHigh

Gets or sets the normal high.

string

None.
NormalLow

Gets or sets the normal low.

string

None.
ObservationGroup

The group this observation belongs to, this is usually dynamic and different than the category

CodedObject

None.
CreatedUpdatedDateTime

Gets or sets the created updated date time.

datetime

None.
Encounter

Gets or sets the encounter type.

Encounter

None.
Patient

Gets or sets the patient class.

BasePatient

None.
Tasks

Gets or sets the List of Tasks

Collection of TaskObject

None.
DocumentedBy

Gets or sets the Providers and their Actions

Collection of ProviderWithAction

None.
CodedResults

Gets or sets the list of CodedResults

Collection of CodedObject

None.
ObservationValueLongText

Gets or sets a list of the Result Values that are long text.

Collection of Note

None.
ObservationComment

Gets or Sets the List ObervationComment

Collection of Note

None.
System

Gets or sets the System

CodedObject

None.

Response Codes

Http Status Code 200 - Indicates that the request was processed successfully.

Http Status Code 400 - Indicates that the request did not contain all the required fields or had an invalid value.

Http Status Code 401 - Indicates that authentication to the underlying EMR server using the provided LoginId and Password failed.

Http Status Code 403 - Indicates that there is an issue with the request UserId.

Http Status Code 408 - Indicates that the request to the underlying EMR server timed out.

Http Status Code 500 - Indicates that an internal server error occurred during processing of the request.

Http Status Code 502 - Indicates that a request made to the underlying EMR server could not be completed.

Response Formats

application/json

[
  {
    "ObservationId": "sample string 1",
    "CategoryId": "sample string 2",
    "CategoryDesc": "sample string 3",
    "OrderId": "sample string 4",
    "ComponentId": "sample string 5",
    "ComponentDesc": "sample string 6",
    "ObservationType": "sample string 7",
    "ObservationStatus": "sample string 8",
    "ObservationValue": "sample string 9",
    "ObservationUnits": "sample string 10",
    "Normalcy": "sample string 11",
    "EffectiveDateTime": "2025-12-12T21:05:50.0422298+00:00",
    "ObservedDateTime": "2025-12-12T21:05:50.0423629+00:00",
    "NormalHigh": "sample string 12",
    "NormalLow": "sample string 13",
    "ObservationGroup": {
      "Id": "sample string 1",
      "Name": "sample string 2"
    },
    "CreatedUpdatedDateTime": "2025-12-12T21:05:50.0428275+00:00",
    "Encounter": {
      "EncounterId": "sample string 1",
      "EncounterType": {
        "Id": "sample string 1",
        "Name": "sample string 2"
      },
      "PatientClass": {
        "Id": "sample string 1",
        "Name": "sample string 2"
      },
      "EncounterDateTime": "2025-12-12T21:05:50.0429543+00:00",
      "DischargeDateTime": "2025-12-12T21:05:50.0429564+00:00",
      "FinancialNumber": "sample string 2",
      "Location": {
        "BedId": "sample string 1",
        "Bed": "sample string 2",
        "RoomId": "sample string 3",
        "Room": "sample string 4",
        "UnitId": "sample string 5",
        "Unit": "sample string 6",
        "HospitalId": "sample string 7",
        "Hospital": "sample string 8"
      }
    },
    "Patient": {
      "PatientId": "sample string 1",
      "DisplayName": "sample string 2",
      "LastName": "sample string 3",
      "FirstName": "sample string 4",
      "MiddleName": "sample string 5",
      "MRN": "sample string 6",
      "BirthDateTime": "2025-12-12T21:05:50.0432225+00:00",
      "Gender": {
        "Id": "sample string 1",
        "Name": "sample string 2"
      },
      "DeceasedDateTime": "2025-12-12T21:05:50.0432254+00:00"
    },
    "Tasks": [
      {
        "TaskId": "sample string 1",
        "TaskClass": {
          "Id": "sample string 1",
          "Name": "sample string 2"
        },
        "TaskStatus": {
          "Id": "sample string 1",
          "Name": "sample string 2"
        },
        "TaskType": {
          "Id": "sample string 1",
          "Name": "sample string 2"
        }
      },
      {
        "TaskId": "sample string 1",
        "TaskClass": {
          "Id": "sample string 1",
          "Name": "sample string 2"
        },
        "TaskStatus": {
          "Id": "sample string 1",
          "Name": "sample string 2"
        },
        "TaskType": {
          "Id": "sample string 1",
          "Name": "sample string 2"
        }
      }
    ],
    "DocumentedBy": [
      {
        "Provider": {
          "ProviderId": "sample string 1",
          "ProviderName": "sample string 2"
        },
        "Action": {
          "Id": "sample string 1",
          "Name": "sample string 2"
        },
        "ActionDateTime": "2025-12-12T21:05:50.0436844+00:00"
      },
      {
        "Provider": {
          "ProviderId": "sample string 1",
          "ProviderName": "sample string 2"
        },
        "Action": {
          "Id": "sample string 1",
          "Name": "sample string 2"
        },
        "ActionDateTime": "2025-12-12T21:05:50.0436844+00:00"
      }
    ],
    "CodedResults": [
      {
        "Id": "sample string 1",
        "Name": "sample string 2"
      },
      {
        "Id": "sample string 1",
        "Name": "sample string 2"
      }
    ],
    "ObservationValueLongText": [
      {
        "Comments": "sample string 1",
        "NoteDateTime": "2025-12-12T21:05:50.0440597+00:00",
        "Format": "sample string 2",
        "IsEncoded": true,
        "Provider": {
          "ProviderId": "sample string 1",
          "ProviderName": "sample string 2"
        },
        "NoteType": "sample string 4"
      },
      {
        "Comments": "sample string 1",
        "NoteDateTime": "2025-12-12T21:05:50.0440597+00:00",
        "Format": "sample string 2",
        "IsEncoded": true,
        "Provider": {
          "ProviderId": "sample string 1",
          "ProviderName": "sample string 2"
        },
        "NoteType": "sample string 4"
      }
    ],
    "ObservationComment": [
      {
        "Comments": "sample string 1",
        "NoteDateTime": "2025-12-12T21:05:50.0440597+00:00",
        "Format": "sample string 2",
        "IsEncoded": true,
        "Provider": {
          "ProviderId": "sample string 1",
          "ProviderName": "sample string 2"
        },
        "NoteType": "sample string 4"
      },
      {
        "Comments": "sample string 1",
        "NoteDateTime": "2025-12-12T21:05:50.0440597+00:00",
        "Format": "sample string 2",
        "IsEncoded": true,
        "Provider": {
          "ProviderId": "sample string 1",
          "ProviderName": "sample string 2"
        },
        "NoteType": "sample string 4"
      }
    ],
    "System": {
      "Id": "sample string 1",
      "Name": "sample string 2"
    }
  },
  {
    "ObservationId": "sample string 1",
    "CategoryId": "sample string 2",
    "CategoryDesc": "sample string 3",
    "OrderId": "sample string 4",
    "ComponentId": "sample string 5",
    "ComponentDesc": "sample string 6",
    "ObservationType": "sample string 7",
    "ObservationStatus": "sample string 8",
    "ObservationValue": "sample string 9",
    "ObservationUnits": "sample string 10",
    "Normalcy": "sample string 11",
    "EffectiveDateTime": "2025-12-12T21:05:50.0422298+00:00",
    "ObservedDateTime": "2025-12-12T21:05:50.0423629+00:00",
    "NormalHigh": "sample string 12",
    "NormalLow": "sample string 13",
    "ObservationGroup": {
      "Id": "sample string 1",
      "Name": "sample string 2"
    },
    "CreatedUpdatedDateTime": "2025-12-12T21:05:50.0428275+00:00",
    "Encounter": {
      "EncounterId": "sample string 1",
      "EncounterType": {
        "Id": "sample string 1",
        "Name": "sample string 2"
      },
      "PatientClass": {
        "Id": "sample string 1",
        "Name": "sample string 2"
      },
      "EncounterDateTime": "2025-12-12T21:05:50.0429543+00:00",
      "DischargeDateTime": "2025-12-12T21:05:50.0429564+00:00",
      "FinancialNumber": "sample string 2",
      "Location": {
        "BedId": "sample string 1",
        "Bed": "sample string 2",
        "RoomId": "sample string 3",
        "Room": "sample string 4",
        "UnitId": "sample string 5",
        "Unit": "sample string 6",
        "HospitalId": "sample string 7",
        "Hospital": "sample string 8"
      }
    },
    "Patient": {
      "PatientId": "sample string 1",
      "DisplayName": "sample string 2",
      "LastName": "sample string 3",
      "FirstName": "sample string 4",
      "MiddleName": "sample string 5",
      "MRN": "sample string 6",
      "BirthDateTime": "2025-12-12T21:05:50.0432225+00:00",
      "Gender": {
        "Id": "sample string 1",
        "Name": "sample string 2"
      },
      "DeceasedDateTime": "2025-12-12T21:05:50.0432254+00:00"
    },
    "Tasks": [
      {
        "TaskId": "sample string 1",
        "TaskClass": {
          "Id": "sample string 1",
          "Name": "sample string 2"
        },
        "TaskStatus": {
          "Id": "sample string 1",
          "Name": "sample string 2"
        },
        "TaskType": {
          "Id": "sample string 1",
          "Name": "sample string 2"
        }
      },
      {
        "TaskId": "sample string 1",
        "TaskClass": {
          "Id": "sample string 1",
          "Name": "sample string 2"
        },
        "TaskStatus": {
          "Id": "sample string 1",
          "Name": "sample string 2"
        },
        "TaskType": {
          "Id": "sample string 1",
          "Name": "sample string 2"
        }
      }
    ],
    "DocumentedBy": [
      {
        "Provider": {
          "ProviderId": "sample string 1",
          "ProviderName": "sample string 2"
        },
        "Action": {
          "Id": "sample string 1",
          "Name": "sample string 2"
        },
        "ActionDateTime": "2025-12-12T21:05:50.0436844+00:00"
      },
      {
        "Provider": {
          "ProviderId": "sample string 1",
          "ProviderName": "sample string 2"
        },
        "Action": {
          "Id": "sample string 1",
          "Name": "sample string 2"
        },
        "ActionDateTime": "2025-12-12T21:05:50.0436844+00:00"
      }
    ],
    "CodedResults": [
      {
        "Id": "sample string 1",
        "Name": "sample string 2"
      },
      {
        "Id": "sample string 1",
        "Name": "sample string 2"
      }
    ],
    "ObservationValueLongText": [
      {
        "Comments": "sample string 1",
        "NoteDateTime": "2025-12-12T21:05:50.0440597+00:00",
        "Format": "sample string 2",
        "IsEncoded": true,
        "Provider": {
          "ProviderId": "sample string 1",
          "ProviderName": "sample string 2"
        },
        "NoteType": "sample string 4"
      },
      {
        "Comments": "sample string 1",
        "NoteDateTime": "2025-12-12T21:05:50.0440597+00:00",
        "Format": "sample string 2",
        "IsEncoded": true,
        "Provider": {
          "ProviderId": "sample string 1",
          "ProviderName": "sample string 2"
        },
        "NoteType": "sample string 4"
      }
    ],
    "ObservationComment": [
      {
        "Comments": "sample string 1",
        "NoteDateTime": "2025-12-12T21:05:50.0440597+00:00",
        "Format": "sample string 2",
        "IsEncoded": true,
        "Provider": {
          "ProviderId": "sample string 1",
          "ProviderName": "sample string 2"
        },
        "NoteType": "sample string 4"
      },
      {
        "Comments": "sample string 1",
        "NoteDateTime": "2025-12-12T21:05:50.0440597+00:00",
        "Format": "sample string 2",
        "IsEncoded": true,
        "Provider": {
          "ProviderId": "sample string 1",
          "ProviderName": "sample string 2"
        },
        "NoteType": "sample string 4"
      }
    ],
    "System": {
      "Id": "sample string 1",
      "Name": "sample string 2"
    }
  }
]

'

GET api/v1/{EMRSystem}/Population/Observations

Returns all Observations (Flowsheets or Clinical Interventions) of all statuses for all patients for a given date range and filtered, optionally, by Locations (facilities) or Categories (list) or Components (list). Observations are used to document interventions during patient visits (e.g. vital signs, pulse oximetry, pain scale, etc.).

Status: Released

URI Parameters


Required
Required if EMRSystem = Cerner, or Epic, or Meditech

Header Parameters

Required if EMRSystem = Allscripts, or Athena, or Cerner, or Meditech, or Sandbox
Data type: Password , Required if EMRSystem = Allscripts, or Athena, or Cerner, or Meditech, or Sandbox
Required if using application keys
Data type: Password , Required if using application keys

Request: {{ method }} {{ url }}

  • Http Request Headers
  • {{header.name}} : {{header.value}} ******
  • Http Request Body
  • {{httpRequestBody}}
  • Http Response Headers
  • {{header.name}} : {{header.value}} ******
  • Http Response Data
  • {{httpResponseData}}