Athena Core Implementation Guide
5.15.0 - release

Athena Core Implementation Guide - Local Development build (v5.15.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

OperationDefinition: Patient Reason for Visit

Official URL: https://fhir.athena.io/OperationDefinition/ah-questionnaireresponse-patient-reason-for-visit Version: 5.15.0
Draft as of 2026-10-23 Computable Name: PatientReasonForVisit

Information Source: athenacoreext

URL: [base]/QuestionnaireResponse/$patient-reason-for-visit

Parameters

UseNameScopeCardinalityTypeBindingDocumentation
INquestionnaireResponse1..1QuestionnaireResponse

Must conform to https://fhir.athena.io/StructureDefinition/ah-patient-reason-for-visit.

OUTwarning0..1OperationOutcome

Non-fatal advisory information about the matching attempt (e.g. low-confidence input, ambiguous text).

OUTmatch0..*

A candidate appointment service-type match for the supplied reason for visit.

OUTmatch.rank1..1positiveInt

Ordinal position of this match among all matches returned for the same response, where 1 is the best match. Rank is stable within a single operation invocation but MUST NOT be compared across different invocations or different QuestionnaireResponse inputs.

OUTmatch.score0..1decimal

Relative confidence score for this match, expressed as a decimal in the range [0, 1]. Scores are meaningful only when compared against other matches returned for the same QuestionnaireResponse input; they MUST NOT be compared across different inputs or invocations.

OUTmatch.serviceType1..1Codingathenahealth Appointment Service Type (Required)

The appointment service-type coding that this match proposes. The coding is drawn from the ah-appointment-service-type value set and corresponds to the service type that the matching algorithm considers most consistent with the patient-supplied reason for visit.