Tross
Demo dataBook a demo
ZEDMED

List patient referrals

List patient referrals newest first.

POSThttps://preview.ontross.com/api/integrations/zedmed/list-patient-referrals
Request Fields
input.patient_id
integer
required
Zedmed patient identifier.
Example
900000001
input.limit
integer
Maximum number of referrals to return. Defaults to 200; maximum 500.
Example
200
Default
200
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
referrals
array
Referrals on the patient's file, newest first.
referrals[].referral_id
integer
Zedmed's number for this referral record.
Example
900000201
referrals[].patient_id
integer
Numeric record key identifying the person referred.
Example
900000001
referrals[].referral_doctor_id
integer
Zedmed's number for the doctor who referred the patient.
Example
900000301
referrals[].referral_doctor_name
string
Name of the doctor who referred the patient.
Example
"Dr Morgan Reed"
referrals[].referral_date
string
Date the referring doctor wrote the referral.
Example
"2026-09-15T00:00:00"
referrals[].treating_doctor_code
string
Code of the doctor the referral is addressed to.
Example
"DEMO_DOC"
referrals[].referral_period
integer
Validity period Zedmed stores for the referral, as a number.
Example
12
referrals[].referral_type
string
Which category of referral this is.
Example
"S"
referrals[].location_id
integer
The referring doctor's practice location, not your clinic.
Example
900000401
referrals[].is_active
string
Y or N string saying whether the referral still stands.
Example
"Y"
referrals[].patient_sessions_total
integer
How many sessions Zedmed counts against this referral.
Example
6
referrals[].provider_number
string
Medicare provider number of the referring doctor there.
Example
"9999991A"
Code
curl --request POST \
  --url https://preview.ontross.com/api/integrations/zedmed/list-patient-referrals \
  --header 'X-API-Key: REPLACE_KEY_VALUE' \
  --header 'content-type: application/json' \
  --data '{"input":{"patient_id":900000001,"limit":200},"auth_id":"auth_uuid_here"}'
Request BODY
{
  "input": {
    "patient_id": 900000001,
    "limit": 200
  },
  "auth_id": "auth_uuid_here"
}
Response BODY
{
  "id": "string",
  "workflow_id": "string",
  "auth_id": "string",
  "status": "string",
  "input": {},
  "output": {
    "referrals": [
      {
        "referral_id": 900000201,
        "patient_id": 900000001,
        "referral_doctor_id": 900000301,
        "referral_doctor_name": "Dr Morgan Reed",
        "referral_date": "2026-09-15T00:00:00",
        "treating_doctor_code": "DEMO_DOC",
        "referral_period": 12,
        "referral_type": "S",
        "location_id": 900000401,
        "is_active": "Y",
        "patient_sessions_total": 6,
        "provider_number": "9999991A"
      }
    ]
  },
  "files": null,
  "created_at": "2019-08-24T14:15:22Z",
  "started_at": "2019-08-24T14:15:22Z",
  "completed_at": "2019-08-24T14:15:22Z"
}