Tross
Demo dataBook a demo
EZDERM

Send encounter prescriptions

Send selected encounter prescriptions to a pharmacy.

POSThttps://preview.ontross.com/api/integrations/ezderm/send-encounter-prescriptions
Request Fields
input.patient_id
string
required
Patient UUID, resolved from a medical record number by list-patients.
Example
"3f7a2c18-9b04-4e51-ae6d-5c21f0a7bd93"
input.encounter_id
string
required
Encounter the request acts on, returned by create-encounter.
Example
"d26f8a40-3b17-4c95-ae82-608c7f0db541"
input.prescription_ids
array
required
Unsent prescriptions on the encounter, each one unique.
Example
["8d47f435-2b59-4ca8-9e03-51db7f2a6c84"]
input.facility_id
string
Clinic from list-facilities, which EZDerm also calls practiceId and clinicId.
Example
"a1d93f57-62b8-4e14-9c70-38fb5d2ea150"
input.pharmacy_id
string
Pharmacy from list-encounter-pharmacies, omit to keep the current default.
Example
"4c19be73-80d5-4a62-9f18-73ea5b0c26d1"
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
encounter_id
string
Encounter the request acts on, returned by create-encounter.
Example
"d26f8a40-3b17-4c95-ae82-608c7f0db541"
pharmacy
object
A patient-favorite pharmacy that EZDerm can receive a NewRx message.
pharmacy.id
string
Favorite store identifier accepted when choosing a prescription destination.
Example
"4c19be73-80d5-4a62-9f18-73ea5b0c26d1"
pharmacy.name
string
Store label returned in the patient's favorites.
Example
"Maple Grove Community Pharmacy"
pharmacy.ncpdp_id
string
Pharmacy's NCPDP store number for eRx routing, sometimes empty.
Example
"9876543"
pharmacy.service_levels
array
eRx capabilities the pharmacy advertises, split from a comma list.
prescriptions
array
One send result per prescription you asked to transmit.
prescriptions[].prescription_id
string
The encounter prescription this send result refers to.
Example
"8D47F435-2B59-4CA8-9E03-51DB7F2A6C84"
prescriptions[].name
string
Returned medication label, falling back to the submitted prescription's label.
Example
"tretinoin 0.025% topical cream"
prescriptions[].status
string
Transmission state returned by the server for this prescription.
Example
"SENT"
prescriptions[].sent_at
string
When Surescripts received the prescription, null if it has not.
Example
"2026-08-06T17:42:15Z"
confirmed
boolean
True only when every prescription came back sent with a timestamp.
Example
true
Code
curl --request POST \
  --url https://preview.ontross.com/api/integrations/ezderm/send-encounter-prescriptions \
  --header 'X-API-Key: REPLACE_KEY_VALUE' \
  --header 'content-type: application/json' \
  --data '{"input":{"patient_id":"3f7a2c18-9b04-4e51-ae6d-5c21f0a7bd93","encounter_id":"d26f8a40-3b17-4c95-ae82-608c7f0db541","facility_id":"a1d93f57-62b8-4e14-9c70-38fb5d2ea150","prescription_ids":["8d47f435-2b59-4ca8-9e03-51db7f2a6c84"],"pharmacy_id":"4c19be73-80d5-4a62-9f18-73ea5b0c26d1"},"auth_id":"auth_uuid_here"}'
Request BODY
{
  "input": {
    "patient_id": "3f7a2c18-9b04-4e51-ae6d-5c21f0a7bd93",
    "encounter_id": "d26f8a40-3b17-4c95-ae82-608c7f0db541",
    "facility_id": "a1d93f57-62b8-4e14-9c70-38fb5d2ea150",
    "prescription_ids": [
      "8d47f435-2b59-4ca8-9e03-51db7f2a6c84"
    ],
    "pharmacy_id": "4c19be73-80d5-4a62-9f18-73ea5b0c26d1"
  },
  "auth_id": "auth_uuid_here"
}
Response BODY
{
  "id": "string",
  "workflow_id": "string",
  "auth_id": "string",
  "status": "string",
  "input": {},
  "output": {
    "encounter_id": "d26f8a40-3b17-4c95-ae82-608c7f0db541",
    "pharmacy": {
      "id": "4c19be73-80d5-4a62-9f18-73ea5b0c26d1",
      "name": "Maple Grove Community Pharmacy",
      "ncpdp_id": "9876543",
      "service_levels": [
        "string"
      ]
    },
    "prescriptions": [
      {
        "prescription_id": "8D47F435-2B59-4CA8-9E03-51DB7F2A6C84",
        "name": "tretinoin 0.025% topical cream",
        "status": "SENT",
        "sent_at": "2026-08-06T17:42:15Z"
      }
    ],
    "confirmed": true
  },
  "files": null,
  "created_at": "2019-08-24T14:15:22Z",
  "started_at": "2019-08-24T14:15:22Z",
  "completed_at": "2019-08-24T14:15:22Z"
}