Search Patients
Perform Search Patients through athenahealth.
athena_search_patientsread
Inputs
- Query
queryexpressionrequiredRequired literal value or workflow expression.
- Filter Type
filter_typeselectOptional selected identifier or value.
Default:
"NAME"Options: Name ("NAME"), Patient ID ("ID")
- Max Results
max_resultsnumberOptional numeric value.
Default:
20
Outputs
successSuccessqueryQueryfilter_typeFilter Typeresult_countResult CountcountCountmatchesMatchessingle_matchSingle Matchpatient_idPatient Idchart_idChart Idfirst_patient_idFirst Patient Idfirst_chart_idFirst Chart Idresponse_lengthResponse LengtherrorErrorerror_messageError Message
Output schema completeness: best_effort_declared
Safety
- External effect
- read
- Confirmation recommended
- No
- Retry safe
- Yes
- Dry run supported
- No
Schemas
These schemas are first-pass authoring guidance. Runtime validation remains authoritative.
Input schema
{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"description": "Required literal value or workflow expression.",
"x-workflow-field-type": "expression"
},
"filter_type": {
"enum": [
"NAME",
"ID"
],
"type": "string",
"default": "NAME",
"description": "Optional selected identifier or value.",
"x-workflow-field-type": "select"
},
"max_results": {
"type": "number",
"default": 20,
"description": "Optional numeric value.",
"x-workflow-field-type": "number"
}
},
"additionalProperties": false
}Output schema
{
"type": "object",
"properties": {
"count": {},
"error": {},
"query": {},
"matches": {},
"success": {},
"chart_id": {},
"patient_id": {},
"filter_type": {},
"result_count": {},
"single_match": {},
"error_message": {},
"first_chart_id": {},
"response_length": {},
"first_patient_id": {}
},
"additionalProperties": true
}