Tross
Demo dataBook a demo
ECLINICALWORKS

Submit drug screening

Record the social history drug screening answer.

POSThttps://preview.ontross.com/api/integrations/ecw/submit-drug-screening

How to complete this screening

Required

patientId, encounterId, and used_drugs_in_past_12_months.

Answer and comments

Use Yes or No. Optionally send comments; eCW saves it with the answer in Social History → Drugs.

Use the exact values listed below. The request body on the right is a valid copy-and-paste starting point.

Request Fields
input.patientId
string
required
eClinicalWorks patient identifier for the current chart.
Example
"112206"
input.encounterId
string
required
Encounter identifier where the Drugs screening will be saved.
Example
"4872822"
input.used_drugs_in_past_12_months
string
required
Answer to: Have you used drugs other than those for medical reasons in the past 12 months?
Example
"No"
Accepted values
YesNo
input.comments
string
Optional free-text comment saved with the Drugs screening answer.
Example
"Patient denies non-medical drug use."
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
submitted
boolean
Whether eCW accepted the smart form submission.
Example
true
Code
curl --request POST \
  --url https://preview.ontross.com/api/integrations/ecw/submit-drug-screening \
  --header 'X-API-Key: REPLACE_KEY_VALUE' \
  --header 'content-type: application/json' \
  --data '{"input":{"patientId":"patient_id","encounterId":"encounter_id","used_drugs_in_past_12_months":"No","comments":"Patient denies non-medical drug use."},"auth_id":"auth_uuid_here"}'
Request BODY
{
  "input": {
    "patientId": "patient_id",
    "encounterId": "encounter_id",
    "used_drugs_in_past_12_months": "No",
    "comments": "Patient denies non-medical drug use."
  },
  "auth_id": "auth_uuid_here"
}
Response BODY
{
  "id": "string",
  "workflow_id": "string",
  "auth_id": "string",
  "status": "string",
  "input": {},
  "output": {
    "submitted": true
  },
  "files": null,
  "created_at": "2019-08-24T14:15:22Z",
  "started_at": "2019-08-24T14:15:22Z",
  "completed_at": "2019-08-24T14:15:22Z"
}