Tross
Demo dataBook a demo
ECLINICALWORKS

Write hospitalization history

Add hospitalization history rows.

POSThttps://preview.ontross.com/api/integrations/ecw/write-hospitalization-history
Request Fields
input.patientId
string
required
Patient chart being read or written, from fetch-patients.
Example
"100001"
input.encounterId
string
required
Encounter being read or written, from fetch-appointments.
Example
"200001"
input.hospitalizations
array
required
Hospitalization rows to append, skipping duplicates so repeat calls are safe.
Example
[{"date":"06/7375","reason":"stroke"},{"date":"02/7375","reason":"pneumonia"}]
input.hospitalizations[].reason
string
required
Reason for the hospitalization.
Example
"stroke"
input.hospitalizations[].date
string
Optional hospitalization month and year in ECW's MM/YYYY format.
Example
"06/2022"
Default
""
auth_id
string
required
Saved connection to run this operation through, from the Authentication page. It decides which practice and login the call uses.
Example
"00000000-0000-4000-8000-000000000000"
Output Fields
hospitalizationResults
array
One result per hospitalization, saying added or already present.
hospitalizationResults[].date
string
Submitted admission month and year, empty when omitted.
Example
"06/2022"
hospitalizationResults[].reason
string
Why the call or hospitalization happened, saved as row text.
Example
"Pneumonia"
hospitalizationResults[].status
string
Whether the admission was added or already recorded.
Example
"added"
hospitalizationHistorySaved
boolean
Whether eCW saved the hospitalization history section.
Example
true
Code
curl --request POST \
  --url https://preview.ontross.com/api/integrations/ecw/write-hospitalization-history \
  --header 'X-API-Key: REPLACE_KEY_VALUE' \
  --header 'content-type: application/json' \
  --data '{"input":{"encounterId":"200001","hospitalizations":[{"date":"06/2022","reason":"stroke"},{"date":"05/2021","reason":"diarrhea"}],"patientId":"100001"},"auth_id":"auth_uuid_here"}'
Request BODY
{
  "input": {
    "encounterId": "200001",
    "hospitalizations": [
      {
        "date": "06/2022",
        "reason": "stroke"
      },
      {
        "date": "05/2021",
        "reason": "diarrhea"
      }
    ],
    "patientId": "100001"
  },
  "auth_id": "auth_uuid_here"
}
Response BODY
{
  "id": "string",
  "workflow_id": "string",
  "auth_id": "string",
  "status": "string",
  "input": {},
  "output": {
    "hospitalizationResults": [
      {
        "date": "06/2022",
        "reason": "Pneumonia",
        "status": "added"
      }
    ],
    "hospitalizationHistorySaved": true
  },
  "files": null,
  "created_at": "2019-08-24T14:15:22Z",
  "started_at": "2019-08-24T14:15:22Z",
  "completed_at": "2019-08-24T14:15:22Z"
}