Tross
Demo dataBook a demo
ELATION

Get patient

Get patient demographics and coverage summaries.

POSThttps://preview.ontross.com/api/integrations/elation/get-patient
Request Fields
input.patient_id
string
required
Patient whose chart is read or written, from search-patients.
Example
"350949464068019"
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
patient
object
Curated demographics for the patient, social security number omitted.
patient.id
string
Chart owner identifier returned by the demographics endpoint.
Example
"350949464068019"
patient.first_name
string
Patient's given name recorded in the chart.
Example
"Jane"
patient.middle_name
string
Patient's middle name as the chart records it.
Example
"Lee"
patient.last_name
string
Patient's family name recorded in the chart.
Example
"Doe"
patient.dob
string
Recorded birth date formatted as MM/DD/YYYY.
Example
"01/03/1977"
patient.sex
string
Sex as the patient's chart records it.
Example
"F"
patient.age
integer
Reported years of life, null without an integer value.
Example
57
patient.email
string
Email address on the patient's chart.
Example
"avery.testpatient@example.com"
patient.phone1
string
First phone number on the patient's chart.
Example
"312-555-0142"
patient.phone1_type
string
What kind of line the first phone number is.
Example
"Mobile"
patient.phone2
string
Second phone number on the patient's chart.
Example
"312-555-0168"
patient.phone2_type
string
What kind of line the second phone number is.
Example
"Home"
patient.address
string
Street line on the patient's chart address.
Example
"123 Example Avenue"
patient.suite
string
Suite or unit line of the chart address.
Example
"Apt 4B"
patient.city
string
City on the patient's chart address.
Example
"Chicago"
patient.state
string
State on the patient's chart address.
Example
"IL"
patient.zip
string
Postal code on the patient's chart address.
Example
"60601"
patient.chart_number
string
Practice chart number printed on the patient's chart.
Example
"TEST000142"
patient.status
string
Chart activity state from the nested demographics details.
Example
"active"
patient.inactive_reason
string
Why the chart was deactivated, empty for active patients.
Example
"Transferred care"
patient.primary_physician_user_id
string
User id of the chart's assigned practice physician.
Example
"306223"
patient.primary_physician_name
string
Practice physician the chart assigns the patient to.
Example
"Rivera, Alex"
patient.pcp_physician_name
string
Primary care physician named on the chart, possibly outside the practice.
Example
"Morgan Example"
patient.timezone
string
IANA zone stamping the delivery date, America/Chicago by default.
Example
"America/Chicago"
patient.tags
array
Tag labels on the patient, or the practice's document tags.
patient.primary_insurance
object
First coverage slot embedded in demographics, null when empty, not a policy.
patient.primary_insurance.rank
integer
Ordering position, or the slot number for insurance coverage.
Example
1
patient.primary_insurance.carrier
string
Carrier name on the embedded demographics coverage slot.
Example
"Example Health Insurance"
patient.primary_insurance.carrier_id
string
Insurance company behind the coverage slot or gateway policy.
Example
"999000000000401"
patient.primary_insurance.member_id
string
Subscriber's member number on the demographics coverage slot.
Example
"TST845920176"
patient.primary_insurance.group_id
string
Employer group number on the coverage or policy.
Example
"TST48270"
patient.primary_insurance.payment_program
string
Program the coverage slot bills under, as Elation labels it.
Example
"Commercial"
patient.primary_insurance.insured_person_first_name
string
Subscriber's given name when the patient is not the subscriber.
Example
"Avery"
patient.primary_insurance.insured_person_last_name
string
Subscriber's family name when the patient is not the subscriber.
Example
"Testpatient"
patient.primary_insurance.effective_date
string
When the coverage slot started, as demographics records it.
Example
"01/01/2026"
patient.primary_insurance.end_date
string
Coverage termination value copied from the demographics response.
Example
"12/31/2026"
patient.secondary_insurance
object
Second demographics coverage slot, null when empty, separate from policies.
patient.secondary_insurance.rank
integer
Ordering position, or the slot number for insurance coverage.
Example
1
patient.secondary_insurance.carrier
string
Carrier name on the embedded demographics coverage slot.
Example
"Example Health Insurance"
patient.secondary_insurance.carrier_id
string
Insurance company behind the coverage slot or gateway policy.
Example
"999000000000401"
patient.secondary_insurance.member_id
string
Subscriber's member number on the demographics coverage slot.
Example
"TST845920176"
patient.secondary_insurance.group_id
string
Employer group number on the coverage or policy.
Example
"TST48270"
patient.secondary_insurance.payment_program
string
Program the coverage slot bills under, as Elation labels it.
Example
"Commercial"
patient.secondary_insurance.insured_person_first_name
string
Subscriber's given name when the patient is not the subscriber.
Example
"Avery"
patient.secondary_insurance.insured_person_last_name
string
Subscriber's family name when the patient is not the subscriber.
Example
"Testpatient"
patient.secondary_insurance.effective_date
string
When the coverage slot started, as demographics records it.
Example
"01/01/2026"
patient.secondary_insurance.end_date
string
Coverage termination value copied from the demographics response.
Example
"12/31/2026"
patient.tertiary_insurance
object
Third demographics coverage slot, null when empty, separate from policies.
patient.tertiary_insurance.rank
integer
Ordering position, or the slot number for insurance coverage.
Example
1
patient.tertiary_insurance.carrier
string
Carrier name on the embedded demographics coverage slot.
Example
"Example Health Insurance"
patient.tertiary_insurance.carrier_id
string
Insurance company behind the coverage slot or gateway policy.
Example
"999000000000401"
patient.tertiary_insurance.member_id
string
Subscriber's member number on the demographics coverage slot.
Example
"TST845920176"
patient.tertiary_insurance.group_id
string
Employer group number on the coverage or policy.
Example
"TST48270"
patient.tertiary_insurance.payment_program
string
Program the coverage slot bills under, as Elation labels it.
Example
"Commercial"
patient.tertiary_insurance.insured_person_first_name
string
Subscriber's given name when the patient is not the subscriber.
Example
"Avery"
patient.tertiary_insurance.insured_person_last_name
string
Subscriber's family name when the patient is not the subscriber.
Example
"Testpatient"
patient.tertiary_insurance.effective_date
string
When the coverage slot started, as demographics records it.
Example
"01/01/2026"
patient.tertiary_insurance.end_date
string
Coverage termination value copied from the demographics response.
Example
"12/31/2026"
Code
curl --request POST \
  --url https://preview.ontross.com/api/integrations/elation/get-patient \
  --header 'X-API-Key: REPLACE_KEY_VALUE' \
  --header 'content-type: application/json' \
  --data '{"input":{"patient_id":"350949464068019"},"auth_id":"auth_uuid_here"}'
Request BODY
{
  "input": {
    "patient_id": "350949464068019"
  },
  "auth_id": "auth_uuid_here"
}
Response BODY
{
  "id": "string",
  "workflow_id": "string",
  "auth_id": "string",
  "status": "string",
  "input": {},
  "output": {
    "patient": {
      "id": "350949464068019",
      "first_name": "Avery",
      "middle_name": "Lee",
      "last_name": "Testpatient",
      "dob": "04/17/1968",
      "sex": "Female",
      "age": 57,
      "email": "avery.testpatient@example.com",
      "phone1": "312-555-0142",
      "phone1_type": "Mobile",
      "phone2": "312-555-0168",
      "phone2_type": "Home",
      "address": "123 Example Avenue",
      "suite": "Apt 4B",
      "city": "Chicago",
      "state": "IL",
      "zip": "60601",
      "chart_number": "TEST000142",
      "status": "Active",
      "inactive_reason": "Transferred care",
      "primary_physician_user_id": "999000000000201",
      "primary_physician_name": "Dana Whitfield",
      "pcp_physician_name": "Morgan Example",
      "timezone": "America/Chicago",
      "tags": [
        "string"
      ],
      "primary_insurance": {
        "rank": 1,
        "carrier": "Example Health Insurance",
        "carrier_id": "999000000000401",
        "member_id": "TST845920176",
        "group_id": "TST48270",
        "payment_program": "Commercial",
        "insured_person_first_name": "Avery",
        "insured_person_last_name": "Testpatient",
        "effective_date": "01/01/2026",
        "end_date": "12/31/2026"
      },
      "secondary_insurance": {
        "rank": 1,
        "carrier": "Example Health Insurance",
        "carrier_id": "999000000000401",
        "member_id": "TST845920176",
        "group_id": "TST48270",
        "payment_program": "Commercial",
        "insured_person_first_name": "Avery",
        "insured_person_last_name": "Testpatient",
        "effective_date": "01/01/2026",
        "end_date": "12/31/2026"
      },
      "tertiary_insurance": {
        "rank": 1,
        "carrier": "Example Health Insurance",
        "carrier_id": "999000000000401",
        "member_id": "TST845920176",
        "group_id": "TST48270",
        "payment_program": "Commercial",
        "insured_person_first_name": "Avery",
        "insured_person_last_name": "Testpatient",
        "effective_date": "01/01/2026",
        "end_date": "12/31/2026"
      }
    }
  },
  "files": null,
  "created_at": "2019-08-24T14:15:22Z",
  "started_at": "2019-08-24T14:15:22Z",
  "completed_at": "2019-08-24T14:15:22Z"
}