ECLINICALWORKS
Fetch encounters
List billing encounters for a date range.
POSThttps://preview.ontross.com/api/integrations/ecw/fetch-encounters
Request Fields
input.start_date
string
requiredFirst service date of the encounter list filter range.
Example
"03/01/2026"input.end_date
string
requiredLast service date of the encounter list filter range.
Example
"03/31/2026"auth_id
string
requiredSaved 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
encounters
array
The encounter or appointment rows this call returned.
encounters[].encounterID
string
Encounter this row describes, or the patient's last or next appointment.
Example
"987654321"encounters[].patientName
string
Name text matched against the live patient lookup.
Example
"Morgan, Avery"encounters[].PatientId
string
Patient the encounter belongs to.
Example
"876543210"encounters[].providerName
string
Provider on the encounter or smart form, may be null.
Example
"Jordan Ellis, MD"encounters[].date
string
Picks the encounter or schedule day when encounterId is omitted.
Example
"03/12/2026"encounters[].notesstatus
string
Progress note status, lowercase spelling on this operation.
Example
"Signed"encounters[].encType
string
Encounter type code, an integer or string depending on operation.
Example
"1"encounters[].resourceName
string
Resource name on the encounter row.
Example
"Jordan Ellis"encounters[].insuranceid
string
Identifier of the payer on this encounter.
Example
"7654321"encounters[].insurancename
string
Payer name, lowercase here but insuranceName in encounter review.
Example
"Aetna"encounters_total
integer
Total encounter count eCW reported for the date filter.
Example
42Code
curl --request POST \
--url https://preview.ontross.com/api/integrations/ecw/fetch-encounters \
--header 'X-API-Key: REPLACE_KEY_VALUE' \
--header 'content-type: application/json' \
--data '{"input":{"start_date":"03/01/2026","end_date":"03/31/2026"},"auth_id":"auth_uuid_here"}'Request BODY
{
"input": {
"start_date": "03/01/2026",
"end_date": "03/31/2026"
},
"auth_id": "auth_uuid_here"
}Response BODY
{
"id": "string",
"workflow_id": "string",
"auth_id": "string",
"status": "string",
"input": {},
"output": {
"encounters": [
{
"encounterID": "987654321",
"patientName": "Morgan, Avery",
"PatientId": "876543210",
"providerName": "Jordan Ellis, MD",
"date": "03/12/2026",
"notesstatus": "Signed",
"encType": "1",
"resourceName": "Jordan Ellis",
"insuranceid": "7654321",
"insurancename": "Aetna"
}
],
"encounters_total": 42
},
"files": null,
"created_at": "2019-08-24T14:15:22Z",
"started_at": "2019-08-24T14:15:22Z",
"completed_at": "2019-08-24T14:15:22Z"
}