The Elation Health connector lets your AI agent act in each user's Elation Health account. Each user signs in to Elation Health once, and Scalekit stores and refreshes their tokens, so your agent never handles credentials. It comes with 52 tools.
- Tools
- 52
- What they doRead · write · destructive
- 52 · 0 · 052 read0 write0 destructive
- Users sign in with
- SMART on FHIR
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the Elation Health connection
In AgentKit > Connections, create an Elation Health connection. The name you give it is the
connection_nameyour code passes. See Configure connections.Console steps with screenshots
Elation Health connections use SMART on FHIR and act as the signed-in clinician, through Elation’s FHIR R4 API. The tools read data only. The connection already has Elation’s production authorization and token endpoints, which are the same for every practice; you add the audience (
aud), the FHIR server domain, and the client ID and secret of your Elation app.-
Create the connection and copy the redirect URI
In the Scalekit dashboard, go to AgentKit > Connections > Create Connection, find Elation and click Create. Copy the Redirect URI.
-
Register an app with Elation
Register a confidential app with Elation for clinician sign-in, and note its client ID and client secret:
- Add the redirect URI you copied.
- Request refresh tokens (
offline_access).
-
Enter the values on the connection
Back on the Elation connection, enter:
- Client ID and Client Secret: from your Elation app.
- Audience (aud):
https://fhir.elationemr.com/fhir - FHIR Server Domain:
fhir.elationemr.com/fhir
Select
openid(Elation requires it),fhirUserandoffline_access, plususer/*.reador the resource scopes your agent needs, such asuser/Patient.read. Elation uses SMART v1 scopes. Click Save.To test in Elation’s sandbox, replace the production values with these:
Field Sandbox value Authorization Endpoint https://sandbox.fhir.elationemr.com/smart/authorizeToken Endpoint https://sandbox.fhir.elationemr.com/smart/tokenAudience (aud) https://sandbox.fhir.elationemr.com/fhirFHIR Server Domain sandbox.fhir.elationemr.com/fhir
-
Tools
Pass the exact name toexecute_toolelation_allergy_intolerance_readGet one AllergyIntolerance resource from Elation by its ID.Read-onlyGet Allergy Or Intolerance
Get one AllergyIntolerance resource from Elation by its ID. Returns the AllergyIntolerance with code (RxNorm or SNOMED CT substance), clinicalStatus, verificationStatus, category, criticality, reaction (manifestation and severity), onsetDateTime, recordedDate and patient reference. Use this to open one allergy by ID. Use elation_allergy_intolerance_search to list a patient's allergies.
Inputs
allergy_intolerance_idstringrequired- Elation logical ID of the AllergyIntolerance resource (the id element, without the 'AllergyIntolerance/' prefix). Example: 12345.
elation_allergy_intolerance_searchSearch a patient's allergies and intolerances in Elation, optionally filtered by clinical status.Read-onlySearch Allergies And Intolerances
Search a patient's allergies and intolerances in Elation, optionally filtered by clinical status. Returns a FHIR searchset Bundle whose entry array holds matching AllergyIntolerance resources (code, clinicalStatus, verificationStatus, reaction and recordedDate) and a 'next' link when more pages exist. Use this to review a patient's allergy list. Use elation_allergy_intolerance_read for one allergy by ID. Requires an Elation patient ID: run elation_patient_search first. If the result has a 'next' link, use elation_next_page to get more.
Inputs
patientstringrequired- Elation patient ID (the Patient resource id) whose allergies to return. Accepts the bare id or the reference form Patient/<id>. Example: 12345.
_countinteger- Maximum number of resources to return in one page. The server picks a default when omitted. Example: 20.
clinical_statusstring- Filter by clinical status, as a FHIR token: code or system|code. Valid codes: active, inactive, resolved (system http://terminology.hl7.org/CodeSystem/allergyintolerance-clinical). Example: active.
elation_binary_readGet one Binary resource from Elation by its ID.Read-onlyGet Binary Resource
Get one Binary resource from Elation by its ID. Returns the Binary with contentType and base64-encoded data (for example a note or report document). Use this to fetch the content behind a DocumentReference or DiagnosticReport attachment url that points to Binary/<id>.
Inputs
binary_idstringrequired- Elation logical ID of the Binary resource (the id element, without the 'Binary/' prefix). Example: 12345.
elation_care_plan_readGet one CarePlan resource from Elation by its ID.Read-onlyGet Care Plan
Get one CarePlan resource from Elation by its ID. Returns the CarePlan with category (assess-plan), status, intent, text narrative (the assessment and plan), period and patient reference. Use this to open one care plan by ID. Use elation_care_plan_search to list a patient's care plans.
Inputs
care_plan_idstringrequired- Elation logical ID of the CarePlan resource (the id element, without the 'CarePlan/' prefix). Example: 12345.
elation_care_plan_searchSearch a patient's care plans (assessment and plan of treatment) in Elation by date or status.Read-onlySearch Care Plans
Search a patient's care plans (assessment and plan of treatment) in Elation by date or status. Returns a FHIR searchset Bundle whose entry array holds matching CarePlan resources (category, status, intent, text narrative and period) and a 'next' link when more pages exist. Use this to read the assessment and plan of treatment. Use elation_goal_search for the patient's goals. Use elation_care_plan_read for one care plan by ID. Requires an Elation patient ID: run elation_patient_search first. If the result has a 'next' link, use elation_next_page to get more.
Inputs
categorystringrequired- Care plan category. Every search Elation documents sends the US Core assess-plan category; use http://hl7.org/fhir/us/core/CodeSystem/careplan-category|assess-plan.
patientstringrequired- Elation patient ID (the Patient resource id) whose care plans to return. Accepts the bare id or the reference form Patient/<id>. Example: 12345.
_countinteger- Maximum number of resources to return in one page. The server picks a default when omitted. Example: 20.
datestring- Filter by care plan period. Use YYYY-MM-DD (or a full date-time), optionally prefixed with a comparator: ge (on or after), le (on or before), gt, lt. Example: ge2024-01-01.
statusstring- Filter by status. One value or a comma-separated list. Valid values: draft, active, on-hold, revoked, completed, entered-in-error, unknown. Example: active.
elation_care_team_readGet one CareTeam resource from Elation by its ID.Read-onlyGet Care Team
Get one CareTeam resource from Elation by its ID. Returns the CareTeam with status, name, participant (role and member references to Practitioner, PractitionerRole, RelatedPerson or Patient) and patient reference. Use this to open one care team by ID. Use elation_care_team_search to list a patient's care teams.
Inputs
care_team_idstringrequired- Elation logical ID of the CareTeam resource (the id element, without the 'CareTeam/' prefix). Example: 12345.
elation_care_team_searchSearch a patient's care teams in Elation by status or participant role.Read-onlySearch Care Teams
Search a patient's care teams in Elation by status or participant role. Returns a FHIR searchset Bundle whose entry array holds matching CareTeam resources (status, name and participants with their roles) and a 'next' link when more pages exist. Use this to see who is involved in a patient's care. Use elation_practitioner_read to resolve a participant. Use elation_care_team_read for one care team by ID. Requires an Elation patient ID: run elation_patient_search first. If the result has a 'next' link, use elation_next_page to get more.
Inputs
patientstringrequired- Elation patient ID (the Patient resource id) whose care teams to return. Accepts the bare id or the reference form Patient/<id>. Example: 12345.
_countinteger- Maximum number of resources to return in one page. The server picks a default when omitted. Example: 20.
rolestring- Filter by participant role, as a FHIR token: code or system|code. Example: http://snomed.info/sct|446050000.
statusstring- Filter by status. One value or a comma-separated list. Valid values: proposed, active, suspended, inactive, entered-in-error. Example: active.
elation_condition_readGet one Condition resource from Elation by its ID.Read-onlyGet Condition
Get one Condition resource from Elation by its ID. Returns the Condition with code (SNOMED CT or ICD-10), category (problem-list-item, health-concern or encounter-diagnosis), clinicalStatus, verificationStatus, onset and abatement dates, recordedDate, encounter and patient references. Use this to open one problem or diagnosis by ID. Use elation_condition_search to list a patient's problems, health concerns or encounter diagnoses.
Inputs
condition_idstringrequired- Elation logical ID of the Condition resource (the id element, without the 'Condition/' prefix). Example: 12345.
elation_condition_searchSearch a patient's conditions in Elation: problem list items, health concerns and encounter diagnoses, filtered by category, status, code, encounter or date.Read-onlySearch Conditions
Search a patient's conditions in Elation: problem list items, health concerns and encounter diagnoses, filtered by category, status, code, encounter or date. Returns a FHIR searchset Bundle whose entry array holds matching Condition resources (code, category, clinicalStatus, onsetDateTime, recordedDate and encounter) and a 'next' link when more pages exist. Use category problem-list-item for the problem list, health-concern for health concerns, or encounter-diagnosis with an encounter ID for one visit's diagnoses. Use elation_condition_read for one condition by ID. Requires an Elation patient ID: run elation_patient_search first. If the result has a 'next' link, use elation_next_page to get more.
Inputs
patientstringrequired- Elation patient ID (the Patient resource id) whose conditions to return. Accepts the bare id or the reference form Patient/<id>. Example: 12345.
_countinteger- Maximum number of resources to return in one page. The server picks a default when omitted. Example: 20.
abatement_datestring- Filter by abatement (resolution) date. Use YYYY-MM-DD (or a full date-time), optionally prefixed with a comparator: ge (on or after), le (on or before), gt, lt. Example: ge2024-01-01.
asserted_datestring- Filter by asserted date. Use YYYY-MM-DD (or a full date-time), optionally prefixed with a comparator: ge (on or after), le (on or before), gt, lt. Example: ge2024-01-01.
categorystring- Filter by condition category, as a FHIR token: code or system|code. Valid codes: problem-list-item, health-concern, encounter-diagnosis. Example: problem-list-item.
clinical_statusstring- Filter by clinical status, as a FHIR token: code or system|code. Valid codes: active, recurrence, relapse, inactive, remission, resolved (system http://terminology.hl7.org/CodeSystem/condition-clinical). Separate several with commas. Example: active.
codestring- Filter by condition code (SNOMED CT or ICD-10-CM), as a FHIR token: code or system|code. Example: http://snomed.info/sct|44054006.
encounterstring- Return only diagnoses recorded for this Elation encounter ID. Elation documents it combined with category encounter-diagnosis. Example: 67890.
onset_datestring- Filter by onset date. Use YYYY-MM-DD (or a full date-time), optionally prefixed with a comparator: ge (on or after), le (on or before), gt, lt. Example: ge2024-01-01.
recorded_datestring- Filter by date the condition was recorded. Use YYYY-MM-DD (or a full date-time), optionally prefixed with a comparator: ge (on or after), le (on or before), gt, lt. Example: ge2024-01-01.
elation_coverage_readGet one Coverage resource from Elation by its ID.Read-onlyGet Coverage
Get one Coverage resource from Elation by its ID. Returns the Coverage with status, type, subscriberId, relationship, period, payor reference and class (group and plan). Use this to open one insurance coverage by ID. Use elation_coverage_search to list a patient's coverage.
Inputs
coverage_idstringrequired- Elation logical ID of the Coverage resource (the id element, without the 'Coverage/' prefix). Example: 12345.
elation_coverage_searchList a patient's insurance coverage in Elation.Read-onlyList Coverage
List a patient's insurance coverage in Elation. Returns a FHIR searchset Bundle whose entry array holds matching Coverage resources (status, type, subscriberId, relationship, period, payor and class) and a 'next' link when more pages exist. Use this to check a patient's insurance. Use elation_organization_read to resolve the payor. Use elation_coverage_read for one coverage by ID. Requires an Elation patient ID: run elation_patient_search first. If the result has a 'next' link, use elation_next_page to get more.
Inputs
patientstringrequired- Elation patient ID (the Patient resource id) whose insurance coverage to return. Accepts the bare id or the reference form Patient/<id>. Example: 12345.
_countinteger- Maximum number of resources to return in one page. The server picks a default when omitted. Example: 20.
elation_device_readGet one Device resource from Elation by its ID.Read-onlyGet Device
Get one Device resource from Elation by its ID. Returns the Device with udiCarrier, deviceName, type, status, expirationDate, lotNumber and patient reference. Use this to open one implantable device by ID. Use elation_device_search to list a patient's implantable devices.
Inputs
device_idstringrequired- Elation logical ID of the Device resource (the id element, without the 'Device/' prefix). Example: 12345.
elation_device_searchSearch a patient's implantable devices in Elation by type or status.Read-onlySearch Devices
Search a patient's implantable devices in Elation by type or status. Returns a FHIR searchset Bundle whose entry array holds matching Device resources (udiCarrier, type, status, deviceName and expirationDate) and a 'next' link when more pages exist. Use this to review implanted devices and their UDIs. Use elation_device_read for one device by ID. Requires an Elation patient ID: run elation_patient_search first. If the result has a 'next' link, use elation_next_page to get more.
Inputs
patientstringrequired- Elation patient ID (the Patient resource id) whose devices to return. Accepts the bare id or the reference form Patient/<id>. Example: 12345.
_countinteger- Maximum number of resources to return in one page. The server picks a default when omitted. Example: 20.
statusstring- Filter by status. One value or a comma-separated list. Valid values: active, inactive, entered-in-error, unknown. Example: active.
typestring- Filter by device type, as a FHIR token: code or system|code. Example: http://snomed.info/sct|468063009.
elation_diagnostic_report_readGet one DiagnosticReport resource from Elation by its ID.Read-onlyGet Diagnostic Report
Get one DiagnosticReport resource from Elation by its ID. Returns the DiagnosticReport with code (LOINC), category (for example LAB), status, effectiveDateTime, issued, result references to Observations, presentedForm and patient reference. Use this to open one lab or imaging report by ID. Use elation_diagnostic_report_search to list a patient's reports.
Inputs
diagnostic_report_idstringrequired- Elation logical ID of the DiagnosticReport resource (the id element, without the 'DiagnosticReport/' prefix). Example: 12345.
elation_diagnostic_report_searchSearch a patient's diagnostic reports in Elation (lab and imaging reports) by category, code, date or status.Read-onlySearch Diagnostic Reports
Search a patient's diagnostic reports in Elation (lab and imaging reports) by category, code, date or status. Returns a FHIR searchset Bundle whose entry array holds matching DiagnosticReport resources (code, category, status, effectiveDateTime, issued and result references) and a 'next' link when more pages exist. Use this for whole reports. Use elation_observation_search for individual result values. Use elation_diagnostic_report_read for one report by ID. Requires an Elation patient ID: run elation_patient_search first. If the result has a 'next' link, use elation_next_page to get more.
Inputs
patientstringrequired- Elation patient ID (the Patient resource id) whose diagnostic reports to return. Accepts the bare id or the reference form Patient/<id>. Example: 12345.
_countinteger- Maximum number of resources to return in one page. The server picks a default when omitted. Example: 20.
categorystring- Filter by report category, as a FHIR token: code or system|code. Example: http://terminology.hl7.org/CodeSystem/v2-0074|LAB.
codestring- Filter by report code (LOINC). Separate several with commas, as a FHIR token: code or system|code. Example: http://loinc.org|58410-2.
datestring- Filter by report effective date. Use YYYY-MM-DD (or a full date-time), optionally prefixed with a comparator: ge (on or after), le (on or before), gt, lt. Example: ge2024-01-01.
statusstring- Filter by status. One value or a comma-separated list. Valid values: registered, partial, preliminary, final, amended, corrected, appended, cancelled, entered-in-error, unknown. Example: final.
elation_document_reference_readGet one DocumentReference resource from Elation by its ID.Read-onlyGet Document Reference
Get one DocumentReference resource from Elation by its ID. Returns the DocumentReference with type (LOINC note type), category, status, date, author, context (encounter and period) and content attachments (contentType and url or base64 data). Use this to open one clinical note or document by ID. Use elation_document_reference_search to list a patient's notes. Use elation_binary_read to fetch content behind an attachment url that points to a Binary resource.
Inputs
document_reference_idstringrequired- Elation logical ID of the DocumentReference resource (the id element, without the 'DocumentReference/' prefix). Example: 12345.
elation_document_reference_searchSearch a patient's clinical notes and documents in Elation by category, type, date, period or status.Read-onlySearch Document References
Search a patient's clinical notes and documents in Elation by category, type, date, period or status. Returns a FHIR searchset Bundle whose entry array holds matching DocumentReference resources (type, category, date, author, status and content attachments) and a 'next' link when more pages exist. Use category clinical-note for clinical notes. Use elation_diagnostic_report_search for lab and imaging reports. Use elation_document_reference_read for one document by ID. Requires an Elation patient ID: run elation_patient_search first. If the result has a 'next' link, use elation_next_page to get more.
Inputs
patientstringrequired- Elation patient ID (the Patient resource id) whose documents to return. Accepts the bare id or the reference form Patient/<id>. Example: 12345.
_countinteger- Maximum number of resources to return in one page. The server picks a default when omitted. Example: 20.
_idstring- Return only the resource with this logical id, wrapped in a searchset Bundle. Example: 12345.
categorystring- Filter by document category, as a FHIR token: code or system|code. Elation documents clinical-note (system http://hl7.org/fhir/us/core/CodeSystem/us-core-documentreference-category). Example: clinical-note.
datestring- Filter by date the document was created. Use YYYY-MM-DD (or a full date-time), optionally prefixed with a comparator: ge (on or after), le (on or before), gt, lt. Example: ge2024-01-01.
periodstring- Filter by time of service covered by the document. Use YYYY-MM-DD (or a full date-time), optionally prefixed with a comparator: ge (on or after), le (on or before), gt, lt. Example: ge2024-01-01.
statusstring- Filter by status. One value or a comma-separated list. Valid values: current, superseded, entered-in-error. Example: current.
typestring- Filter by document type (LOINC note type), as a FHIR token: code or system|code. Example: http://loinc.org|11506-3.
elation_encounter_readGet one Encounter resource from Elation by its ID.Read-onlyGet Encounter
Get one Encounter resource from Elation by its ID. Returns the Encounter with status, class, type, period, participant (practitioners), location, reasonCode, serviceProvider and patient reference. Use this to open one visit by ID. Use elation_encounter_search to list a patient's visits.
Inputs
encounter_idstringrequired- Elation logical ID of the Encounter resource (the id element, without the 'Encounter/' prefix). Example: 12345.
elation_encounter_searchSearch Elation encounters (visits) for a patient by date, class, type, status or location, or look one up by identifier.Read-onlySearch Encounters
Search Elation encounters (visits) for a patient by date, class, type, status or location, or look one up by identifier. Returns a FHIR searchset Bundle whose entry array holds matching Encounter resources (status, class, type, period, participant and location) and a 'next' link when more pages exist. Use this to list a patient's visits. Pass an encounter ID to elation_condition_search (category encounter-diagnosis) or elation_medication_request_search to see what happened at a visit. Use elation_encounter_read for one encounter by ID. Requires an Elation patient ID (run elation_patient_search first) unless you search by Identifier or Resource ID. If the result has a 'next' link, use elation_next_page to get more.
Inputs
_countinteger- Maximum number of resources to return in one page. The server picks a default when omitted. Example: 20.
_idstring- Return only the resource with this logical id, wrapped in a searchset Bundle. Example: 12345.
classstring- Filter by encounter class, as a FHIR token: code or system|code. Codes come from http://terminology.hl7.org/CodeSystem/v3-ActCode, e.g. AMB (ambulatory), VR (virtual). Example: AMB.
datestring- Filter by encounter date. Use YYYY-MM-DD (or a full date-time), optionally prefixed with a comparator: ge (on or after), le (on or before), gt, lt. Example: ge2024-01-01.
identifierstring- Filter by an encounter identifier, as a FHIR token: code or system|code. Example: 67890.
locationstring- Return only encounters at this Elation Location ID. Example: 2468.
patientstring- Elation patient ID (the Patient resource id) whose encounters to return. Accepts the bare id or the reference form Patient/<id>. Example: 12345.
statusstring- Filter by status. One value or a comma-separated list. Valid values: planned, arrived, triaged, in-progress, onleave, finished, cancelled, entered-in-error, unknown. Example: finished.
typestring- Filter by encounter type, as a FHIR token: code or system|code. Example: http://snomed.info/sct|185349003.
elation_goal_readGet one Goal resource from Elation by its ID.Read-onlyGet Goal
Get one Goal resource from Elation by its ID. Returns the Goal with lifecycleStatus, achievementStatus, description, target (measure, detail and due date), startDate and patient reference. Use this to open one goal by ID. Use elation_goal_search to list a patient's goals.
Inputs
goal_idstringrequired- Elation logical ID of the Goal resource (the id element, without the 'Goal/' prefix). Example: 12345.
elation_goal_searchSearch a patient's goals in Elation by lifecycle status, target date or description.Read-onlySearch Goals
Search a patient's goals in Elation by lifecycle status, target date or description. Returns a FHIR searchset Bundle whose entry array holds matching Goal resources (description, lifecycleStatus, target and startDate) and a 'next' link when more pages exist. Use this to review care goals. Use elation_care_plan_search for the assessment and plan. Use elation_goal_read for one goal by ID. Requires an Elation patient ID: run elation_patient_search first. If the result has a 'next' link, use elation_next_page to get more.
Inputs
patientstringrequired- Elation patient ID (the Patient resource id) whose goals to return. Accepts the bare id or the reference form Patient/<id>. Example: 12345.
_countinteger- Maximum number of resources to return in one page. The server picks a default when omitted. Example: 20.
descriptionstring- Filter by goal description code, as a FHIR token: code or system|code. Example: http://snomed.info/sct|289169006.
lifecycle_statusstring- Filter by lifecycle status. Valid values: proposed, planned, accepted, active, on-hold, completed, cancelled, entered-in-error, rejected. Example: active.
target_datestring- Filter by goal target date. Use YYYY-MM-DD (or a full date-time), optionally prefixed with a comparator: ge (on or after), le (on or before), gt, lt. Example: ge2024-01-01.
elation_immunization_readGet one Immunization resource from Elation by its ID.Read-onlyGet Immunization
Get one Immunization resource from Elation by its ID. Returns the Immunization with vaccineCode (CVX), status, occurrenceDateTime, lotNumber, site, route, performer and patient reference. Use this to open one immunization by ID. Use elation_immunization_search to list a patient's immunizations.
Inputs
immunization_idstringrequired- Elation logical ID of the Immunization resource (the id element, without the 'Immunization/' prefix). Example: 12345.
elation_immunization_searchSearch a patient's immunizations in Elation by date or status.Read-onlySearch Immunizations
Search a patient's immunizations in Elation by date or status. Returns a FHIR searchset Bundle whose entry array holds matching Immunization resources (vaccineCode, status, occurrenceDateTime and lotNumber) and a 'next' link when more pages exist. Use this to review a patient's vaccine history. Use elation_immunization_read for one immunization by ID. Requires an Elation patient ID: run elation_patient_search first. If the result has a 'next' link, use elation_next_page to get more.
Inputs
patientstringrequired- Elation patient ID (the Patient resource id) whose immunizations to return. Accepts the bare id or the reference form Patient/<id>. Example: 12345.
_countinteger- Maximum number of resources to return in one page. The server picks a default when omitted. Example: 20.
datestring- Filter by date the vaccine was given. Use YYYY-MM-DD (or a full date-time), optionally prefixed with a comparator: ge (on or after), le (on or before), gt, lt. Example: ge2024-01-01.
statusstring- Filter by status. One value or a comma-separated list. Valid values: completed, entered-in-error, not-done. Example: completed.
elation_location_readGet one Location resource from Elation by its ID.Read-onlyGet Location
Get one Location resource from Elation by its ID. Returns the Location with name, status, address, telecom, type and managingOrganization reference. Use this to resolve a location reference on an encounter. Use elation_location_search to find locations by name or address.
Inputs
location_idstringrequired- Elation logical ID of the Location resource (the id element, without the 'Location/' prefix). Example: 12345.
elation_location_searchSearch Elation locations (practice sites and service locations) by name, address, city, state or postal code.Read-onlySearch Locations
Search Elation locations (practice sites and service locations) by name, address, city, state or postal code. Returns a FHIR searchset Bundle whose entry array holds matching Location resources (name, status, address, telecom and managingOrganization) and a 'next' link when more pages exist. Use this to find a practice site. Pass its ID to elation_encounter_search to list visits there. Use elation_location_read when you already have the ID. If the result has a 'next' link, use elation_next_page to get more.
Inputs
_countinteger- Maximum number of resources to return in one page. The server picks a default when omitted. Example: 20.
addressstring- Filter by any part of the location's address. Matches values that start with the text, case-insensitive. Example: Arbor.
address_citystring- Filter by city. Matches values that start with the text, case-insensitive. Example: Ann Arbor.
address_postalcodestring- Filter by postal code. Matches values that start with the text, case-insensitive. Example: 48104.
address_statestring- Filter by state (two-letter code). Matches values that start with the text, case-insensitive. Example: MI.
namestring- Filter by location name. Matches values that start with the text, case-insensitive. Example: Health.
elation_medication_dispense_readGet one MedicationDispense resource from Elation by its ID.Read-onlyGet Medication Dispense
Get one MedicationDispense resource from Elation by its ID. Returns the MedicationDispense with status, medication, quantity, daysSupply, whenHandedOver, dosageInstruction and authorizingPrescription reference. Use this to open one pharmacy fill by ID. Use elation_medication_dispense_search to list a patient's fills.
Inputs
medication_dispense_idstringrequired- Elation logical ID of the MedicationDispense resource (the id element, without the 'MedicationDispense/' prefix). Example: 12345.
elation_medication_dispense_searchSearch a patient's medication dispenses (pharmacy fills) in Elation by status or type.Read-onlySearch Medication Dispenses
Search a patient's medication dispenses (pharmacy fills) in Elation by status or type. Returns a FHIR searchset Bundle whose entry array holds matching MedicationDispense resources (medication, status, quantity, daysSupply and whenHandedOver) and a 'next' link when more pages exist. Use this to check whether prescriptions were filled. Use elation_medication_request_search for what was prescribed. Use elation_medication_dispense_read for one dispense by ID. Requires an Elation patient ID: run elation_patient_search first. If the result has a 'next' link, use elation_next_page to get more.
Inputs
patientstringrequired- Elation patient ID (the Patient resource id) whose medication dispenses to return. Accepts the bare id or the reference form Patient/<id>. Example: 12345.
_countinteger- Maximum number of resources to return in one page. The server picks a default when omitted. Example: 20.
statusstring- Filter by status. One value or a comma-separated list. Valid values: preparation, in-progress, cancelled, on-hold, completed, entered-in-error, stopped, declined, unknown. Example: completed.
typestring- Filter by dispense type, as a FHIR token: code or system|code. Example: http://terminology.hl7.org/CodeSystem/v3-ActCode|FF.
elation_medication_readGet one Medication resource from Elation by its ID.Read-onlyGet Medication
Get one Medication resource from Elation by its ID. Returns the Medication with code (RxNorm), form, ingredient and status. Use this to resolve the medicationReference on a MedicationRequest or MedicationDispense into drug details.
Inputs
medication_idstringrequired- Elation logical ID of the Medication resource (the id element, without the 'Medication/' prefix). Example: 12345.
elation_medication_request_readGet one MedicationRequest resource from Elation by its ID.Read-onlyGet Medication Request
Get one MedicationRequest resource from Elation by its ID. Returns the MedicationRequest with status, intent, medicationCodeableConcept or medicationReference, dosageInstruction, dispenseRequest, authoredOn, requester and patient reference. Use this to open one prescription or medication order by ID. Use elation_medication_request_search to list a patient's medications.
Inputs
medication_request_idstringrequired- Elation logical ID of the MedicationRequest resource (the id element, without the 'MedicationRequest/' prefix). Example: 12345.
elation_medication_request_searchSearch a patient's medication requests (prescriptions and medication list entries) in Elation by intent, status, date or encounter.Read-onlySearch Medication Requests
Search a patient's medication requests (prescriptions and medication list entries) in Elation by intent, status, date or encounter. Returns a FHIR searchset Bundle whose entry array holds matching MedicationRequest resources (medication, status, intent, dosageInstruction, authoredOn and requester) and a 'next' link when more pages exist. Use this to review a patient's current or past medications. Use elation_medication_read to resolve a medicationReference. Use elation_medication_dispense_search for pharmacy fills. Requires an Elation patient ID: run elation_patient_search first. If the result has a 'next' link, use elation_next_page to get more.
Inputs
intentstringrequired- Request intent. Every search Elation documents sends intent, normally order,plan to get both orders and medication-list entries. Valid values: proposal, plan, order, original-order, reflex-order, filler-order, instance-order, option. Example: order,plan.
patientstringrequired- Elation patient ID (the Patient resource id) whose medication requests to return. Accepts the bare id or the reference form Patient/<id>. Example: 12345.
_countinteger- Maximum number of resources to return in one page. The server picks a default when omitted. Example: 20.
authoredonstring- Filter by date the request was written. Use YYYY-MM-DD (or a full date-time), optionally prefixed with a comparator: ge (on or after), le (on or before), gt, lt. Example: ge2024-01-01.
encounterstring- Return only requests written during this Elation encounter ID. Example: 67890.
statusstring- Filter by status. One value or a comma-separated list. Valid values: active, on-hold, cancelled, completed, entered-in-error, stopped, draft, unknown. Example: active.
elation_next_pageGet the next page of results from an Elation search tool by following the 'next' link in its result Bundle.Read-onlyGet Next Page of Search Results
Get the next page of results from an Elation search tool by following the 'next' link in its result Bundle. Returns a FHIR searchset Bundle like the original search; when it has no 'next' link, it is the last page. Use this after any elation_*_search tool when its result has a 'next' link.
Inputs
next_page_pathstringrequired- The part of the search result's 'next' link url that comes after /fhir/, starting with the resource type and keeping the whole query string exactly as returned; no leading slash. Example: for the next link https://fhir.elationemr.com/fhir/Observation?patient=12345&_count=20&<page token> pass Observation?patient=12345&_count=20&<page token>, copying the page token parameters unchanged.
elation_observation_readGet one Observation resource from Elation by its ID.Read-onlyGet Observation
Get one Observation resource from Elation by its ID. Returns the Observation with code (LOINC), category, status, effectiveDateTime, valueQuantity or other value, interpretation, referenceRange and patient reference. Use this to open one observation by ID. Use elation_observation_search to list a patient's vitals, lab results or assessments.
Inputs
observation_idstringrequired- Elation logical ID of the Observation resource (the id element, without the 'Observation/' prefix). Example: 12345.
elation_observation_searchSearch a patient's observations in Elation: vital signs, lab results, smoking status, social history, SDOH and other assessments, by category, code, date or status.Read-onlySearch Observations
Search a patient's observations in Elation: vital signs, lab results, smoking status, social history, SDOH and other assessments, by category, code, date or status. Returns a FHIR searchset Bundle whose entry array holds matching Observation resources (code, category, value, effectiveDateTime, status and interpretation) and a 'next' link when more pages exist. Use category vital-signs, laboratory, social-history, survey or imaging to narrow, or a LOINC code for one measurement. Use elation_diagnostic_report_search for whole lab or imaging reports. Use elation_observation_read for one observation by ID. Requires an Elation patient ID: run elation_patient_search first. If the result has a 'next' link, use elation_next_page to get more.
Inputs
patientstringrequired- Elation patient ID (the Patient resource id) whose observations to return. Accepts the bare id or the reference form Patient/<id>. Example: 12345.
_countinteger- Maximum number of resources to return in one page. The server picks a default when omitted. Example: 20.
categorystring- Filter by observation category, as a FHIR token: code or system|code. Common codes: vital-signs, laboratory, social-history, survey, imaging, sdoh (system http://terminology.hl7.org/CodeSystem/observation-category). Example: vital-signs.
codestring- Filter by observation code (LOINC). Separate several with commas, as a FHIR token: code or system|code. Example: http://loinc.org|8867-4.
datestring- Filter by date the observation was made. Use YYYY-MM-DD (or a full date-time), optionally prefixed with a comparator: ge (on or after), le (on or before), gt, lt. Example: ge2024-01-01.
statusstring- Filter by status. One value or a comma-separated list. Valid values: registered, preliminary, final, amended, corrected, cancelled, entered-in-error, unknown. Example: final.
elation_organization_readGet one Organization resource from Elation by its ID.Read-onlyGet Organization
Get one Organization resource from Elation by its ID. Returns the Organization with name, identifier (including NPI and TIN), type, telecom and address. Use this to resolve an organization reference, for example a payor or service provider. Use elation_organization_search to find organizations by name or address.
Inputs
organization_idstringrequired- Elation logical ID of the Organization resource (the id element, without the 'Organization/' prefix). Example: 12345.
elation_organization_searchSearch Elation organizations (practices, payers and other organizations) by name or address.Read-onlySearch Organizations
Search Elation organizations (practices, payers and other organizations) by name or address. Returns a FHIR searchset Bundle whose entry array holds matching Organization resources (name, identifier, type, telecom and address) and a 'next' link when more pages exist. Use this to find an organization by name. Use elation_organization_read when you already have the ID. If the result has a 'next' link, use elation_next_page to get more.
Inputs
_countinteger- Maximum number of resources to return in one page. The server picks a default when omitted. Example: 20.
addressstring- Filter by any part of the organization's address. Matches values that start with the text, case-insensitive. Example: Arbor.
namestring- Filter by organization name. Matches values that start with the text, case-insensitive. Example: Health.
elation_patient_readGet one Patient resource from Elation by its ID.Read-onlyGet Patient
Get one Patient resource from Elation by its ID. Returns the Patient with id, identifier (for example an MRN), name, gender, birthDate, telecom, address, communication and US Core race, ethnicity and gender identity extensions. Use this when you already have the patient ID. Use elation_patient_search to find a patient by name, birth date or identifier.
Inputs
patient_idstringrequired- Elation logical ID of the Patient resource (the id element, without the 'Patient/' prefix). Example: 12345.
elation_patient_searchSearch Elation patients by demographics such as name, birth date, gender or identifier.Read-onlySearch Patients
Search Elation patients by demographics such as name, birth date, gender or identifier. Returns a FHIR searchset Bundle whose entry array holds matching Patient resources (id, name, gender, birthDate, identifier, telecom and address) and a 'next' link when more pages exist. Use this to find candidate patients and let the clinician pick one. Use elation_patient_read when you already have the ID. If the result has a 'next' link, use elation_next_page to get more.
Inputs
_countinteger- Maximum number of resources to return in one page. The server picks a default when omitted. Example: 20.
_idstring- Return only the resource with this logical id, wrapped in a searchset Bundle. Example: 12345.
birthdatestring- Patient's date of birth as YYYY-MM-DD. Elation documents it combined with family or name. Example: 1980-01-01.
death_datestring- Patient's date of death as YYYY-MM-DD. Elation documents it combined with family. Example: 2024-01-01.
familystring- Filter by family (last) name. Matches values that start with the text, case-insensitive. Example: Smith.
genderstring- Administrative gender. Elation documents it combined with name or family. Valid values: male, female, other, unknown.one of
malefemaleotherunknown givenstring- Filter by given (first) name. Matches values that start with the text, case-insensitive. Example: Jane.
identifierstring- Filter by a patient identifier such as an MRN, as a FHIR token: code or system|code. Example: 12345.
namestring- Filter by any part of the patient's name (given or family). Matches values that start with the text, case-insensitive. Example: Jane Smith.
elation_practitioner_readGet one Practitioner resource from Elation by its ID.Read-onlyGet Practitioner
Get one Practitioner resource from Elation by its ID. Returns the Practitioner with name, identifier (including NPI), telecom, address, gender and qualification. Use this to resolve a practitioner reference (for example a requester, performer or author) into a name and NPI. Use elation_practitioner_search to find practitioners by name or identifier.
Inputs
practitioner_idstringrequired- Elation logical ID of the Practitioner resource (the id element, without the 'Practitioner/' prefix). Example: 12345.
elation_practitioner_role_readGet one PractitionerRole resource from Elation by its ID.Read-onlyGet Practitioner Role
Get one PractitionerRole resource from Elation by its ID. Returns the PractitionerRole with practitioner and organization references, code (role), specialty, location and telecom. Use this to open one practitioner role by ID. Use elation_practitioner_role_search to find roles by practitioner or specialty.
Inputs
practitioner_role_idstringrequired- Elation logical ID of the PractitionerRole resource (the id element, without the 'PractitionerRole/' prefix). Example: 12345.
elation_practitioner_role_searchSearch Elation practitioner roles by practitioner, practitioner name or identifier, or specialty.Read-onlySearch Practitioner Roles
Search Elation practitioner roles by practitioner, practitioner name or identifier, or specialty. Returns a FHIR searchset Bundle whose entry array holds matching PractitionerRole resources (practitioner, organization, code, specialty, location and telecom) and a 'next' link when more pages exist. Use this to find which practice and specialty a clinician belongs to. Use elation_practitioner_search to find the clinician first. Use elation_practitioner_role_read for one role by ID. If the result has a 'next' link, use elation_next_page to get more.
Inputs
_countinteger- Maximum number of resources to return in one page. The server picks a default when omitted. Example: 20.
practitionerstring- Return roles for this Elation Practitioner ID. Example: 13579.
practitioner_identifierstring- Return roles whose practitioner has this identifier, such as an NPI, as code or system|code. Example: http://hl7.org/fhir/sid/us-npi|1234567890.
practitioner_namestring- Return roles whose practitioner's name contains this text. Example: Smith.
specialtystring- Filter by specialty (NUCC taxonomy), as a FHIR token: code or system|code. Example: http://nucc.org/provider-taxonomy|207Q00000X.
elation_practitioner_searchSearch Elation practitioners (physicians, nurses and other clinicians) by name or identifier such as NPI.Read-onlySearch Practitioners
Search Elation practitioners (physicians, nurses and other clinicians) by name or identifier such as NPI. Returns a FHIR searchset Bundle whose entry array holds matching Practitioner resources (name, identifier including NPI, telecom and qualification) and a 'next' link when more pages exist. Use this to find a clinician by name or NPI. Use elation_practitioner_role_search for a practitioner's roles and specialties. Use elation_practitioner_read for one practitioner by ID. If the result has a 'next' link, use elation_next_page to get more.
Inputs
_countinteger- Maximum number of resources to return in one page. The server picks a default when omitted. Example: 20.
_idstring- Return only the resource with this logical id, wrapped in a searchset Bundle. Example: 12345.
identifierstring- Filter by practitioner identifier, such as an NPI, as a FHIR token: code or system|code. Example: http://hl7.org/fhir/sid/us-npi|1234567890.
namestring- Filter by any part of the practitioner's name. Matches values that start with the text, case-insensitive. Example: Smith.
elation_procedure_readGet one Procedure resource from Elation by its ID.Read-onlyGet Procedure
Get one Procedure resource from Elation by its ID. Returns the Procedure with code (CPT, SNOMED CT or similar), status, performedDateTime or performedPeriod, performer, reasonCode and patient reference. Use this to open one procedure by ID. Use elation_procedure_search to list a patient's procedures.
Inputs
procedure_idstringrequired- Elation logical ID of the Procedure resource (the id element, without the 'Procedure/' prefix). Example: 12345.
elation_procedure_searchSearch a patient's procedures in Elation by code, date or status.Read-onlySearch Procedures
Search a patient's procedures in Elation by code, date or status. Returns a FHIR searchset Bundle whose entry array holds matching Procedure resources (code, status, performedDateTime or performedPeriod and performer) and a 'next' link when more pages exist. Use this to review procedures done to the patient. Use elation_service_request_search for ordered procedures and referrals. Use elation_procedure_read for one procedure by ID. Requires an Elation patient ID: run elation_patient_search first. If the result has a 'next' link, use elation_next_page to get more.
Inputs
patientstringrequired- Elation patient ID (the Patient resource id) whose procedures to return. Accepts the bare id or the reference form Patient/<id>. Example: 12345.
_countinteger- Maximum number of resources to return in one page. The server picks a default when omitted. Example: 20.
codestring- Filter by procedure code, as a FHIR token: code or system|code. Example: http://www.ama-assn.org/go/cpt|99213.
datestring- Filter by date the procedure was performed. Use YYYY-MM-DD (or a full date-time), optionally prefixed with a comparator: ge (on or after), le (on or before), gt, lt. Example: ge2024-01-01.
statusstring- Filter by status. One value or a comma-separated list. Valid values: preparation, in-progress, not-done, on-hold, stopped, completed, entered-in-error, unknown. Example: completed.
elation_provenance_readGet one Provenance resource from Elation by its ID.Read-onlyGet Provenance Record
Get one Provenance resource from Elation by its ID. Returns the Provenance with target references, recorded time, agent (author and organization) and activity. Use this to see who created or last changed a record and when, given a Provenance ID.
Inputs
provenance_idstringrequired- Elation logical ID of the Provenance resource (the id element, without the 'Provenance/' prefix). Example: 12345.
elation_questionnaire_response_readGet one QuestionnaireResponse resource from Elation by its ID.Read-onlyGet Questionnaire Response
Get one QuestionnaireResponse resource from Elation by its ID. Returns the QuestionnaireResponse with questionnaire (canonical), status, authored, author and item answers. Use this to open one completed questionnaire by ID. Use elation_questionnaire_response_search to list a patient's questionnaire responses.
Inputs
questionnaire_response_idstringrequired- Elation logical ID of the QuestionnaireResponse resource (the id element, without the 'QuestionnaireResponse/' prefix). Example: 12345.
elation_questionnaire_response_searchSearch a patient's questionnaire responses in Elation (screenings and SDOH assessments) by status, authored date, questionnaire or tag.Read-onlySearch Questionnaire Responses
Search a patient's questionnaire responses in Elation (screenings and SDOH assessments) by status, authored date, questionnaire or tag. Returns a FHIR searchset Bundle whose entry array holds matching QuestionnaireResponse resources (questionnaire, status, authored and item answers) and a 'next' link when more pages exist. Use tag sdoh for SDOH assessments. Use elation_observation_search with category survey for scored results. Use elation_questionnaire_response_read for one response by ID. Requires an Elation patient ID: run elation_patient_search first. If the result has a 'next' link, use elation_next_page to get more.
Inputs
patientstringrequired- Elation patient ID (the Patient resource id) whose questionnaire responses to return. Accepts the bare id or the reference form Patient/<id>. Example: 12345.
_countinteger- Maximum number of resources to return in one page. The server picks a default when omitted. Example: 20.
_tagstring- Filter by resource tag. Elation documents sdoh for social determinants of health assessments. Example: sdoh.
authoredstring- Filter by date the response was authored. Use YYYY-MM-DD (or a full date-time), optionally prefixed with a comparator: ge (on or after), le (on or before), gt, lt. Example: ge2024-01-01.
questionnairestring- Return only responses to this Questionnaire (id or canonical URL). Example: 13579.
statusstring- Filter by status. One value or a comma-separated list. Valid values: in-progress, completed, amended, entered-in-error, stopped. Example: completed.
elation_service_request_readGet one ServiceRequest resource from Elation by its ID.Read-onlyGet Service Request
Get one ServiceRequest resource from Elation by its ID. Returns the ServiceRequest with code, category, status, intent, authoredOn, requester, performer, reasonCode and patient reference. Use this to open one order or referral by ID. Use elation_service_request_search to list a patient's orders and referrals.
Inputs
service_request_idstringrequired- Elation logical ID of the ServiceRequest resource (the id element, without the 'ServiceRequest/' prefix). Example: 12345.
elation_service_request_searchSearch a patient's service requests in Elation (lab, imaging and procedure orders and referrals) by category, code, date or status.Read-onlySearch Service Requests
Search a patient's service requests in Elation (lab, imaging and procedure orders and referrals) by category, code, date or status. Returns a FHIR searchset Bundle whose entry array holds matching ServiceRequest resources (code, category, status, intent, authoredOn and requester) and a 'next' link when more pages exist. Use this for ordered work. Use elation_procedure_search for procedures already performed. Use elation_service_request_read for one request by ID. Requires an Elation patient ID: run elation_patient_search first. If the result has a 'next' link, use elation_next_page to get more.
Inputs
patientstringrequired- Elation patient ID (the Patient resource id) whose service requests to return. Accepts the bare id or the reference form Patient/<id>. Example: 12345.
_countinteger- Maximum number of resources to return in one page. The server picks a default when omitted. Example: 20.
_idstring- Return only the resource with this logical id, wrapped in a searchset Bundle. Example: 12345.
authoredstring- Filter by date the request was written. Use YYYY-MM-DD (or a full date-time), optionally prefixed with a comparator: ge (on or after), le (on or before), gt, lt. Example: ge2024-01-01.
categorystring- Filter by service request category, as a FHIR token: code or system|code. Example: http://snomed.info/sct|108252007.
codestring- Filter by requested service code, as a FHIR token: code or system|code. Example: http://loinc.org|24323-8.
statusstring- Filter by status. One value or a comma-separated list. Valid values: draft, active, on-hold, revoked, completed, entered-in-error, unknown. Example: active.
elation_specimen_readGet one Specimen resource from Elation by its ID.Read-onlyGet Specimen
Get one Specimen resource from Elation by its ID. Returns the Specimen with type, status, collection (collectedDateTime, bodySite and method), accessionIdentifier and subject reference. Use this to open one specimen by ID, for example from an Observation's specimen reference. Use elation_specimen_search to list a patient's specimens.
Inputs
specimen_idstringrequired- Elation logical ID of the Specimen resource (the id element, without the 'Specimen/' prefix). Example: 12345.
elation_specimen_searchList a patient's specimens in Elation.Read-onlyList Specimens
List a patient's specimens in Elation. Returns a FHIR searchset Bundle whose entry array holds matching Specimen resources (type, status, collection and accessionIdentifier) and a 'next' link when more pages exist. Use this to see specimens collected for lab work. Use elation_specimen_read for one specimen by ID. Requires an Elation patient ID: run elation_patient_search first. If the result has a 'next' link, use elation_next_page to get more.
Inputs
patientstringrequired- Elation patient ID (the Patient resource id) whose specimens to return. Accepts the bare id or the reference form Patient/<id>. Example: 12345.
_countinteger- Maximum number of resources to return in one page. The server picks a default when omitted. Example: 20.
_idstring- Return only the resource with this logical id, wrapped in a searchset Bundle. Example: 12345.
No tools match.
