<status value="active"/> <kind value="operation"/> <experimental value="false"/> <date value="2026-09-30T10:44:40+00:00"/> <publisher value="TEHIK"/> <contact> <name value="TEHIK"/> <telecom> <system value="url"/> <value value="https://tehik.ee"/> </telecom> </contact> <description value="Resolves patient identifiers to MPI Patient references."/> <jurisdiction> <coding> <system value="urn:iso:std:iso:3166"/> <code value="EE"/> <display value="Estonia"/> </coding> </jurisdiction> <affectsState value="false"/> <code value="resolve-reference"/> <comment value="Only POST is supported. identifier.system must be a code of the patsiendi-identifikaatorite-domeen value set, or the value of that code's oid property. An identifier without system or value fails the whole request. If the total number of identifiers exceeds 100, the whole request fails. An invalid system is returned in match.issue. Per-identifier issues do not fail the request: the response is HTTP 200 with a Parameters resource, even if every identifier has an issue."/> <resource value="Patient"/> <system value="false"/> <type value="true"/> <instance value="false"/> <parameter> <name value="identifier"/> <use value="in"/> <min value="1"/> <max value="*"/> <documentation value="Patient identifier to resolve. At least one is required, and system and value are mandatory. identifier.system must be a code of the https://fhir.ee/ValueSet/patsiendi-identifikaatorite-domeen value set, or the value of that code's oid property. At most 100 identifiers per request."/> <type value="Identifier"/> </parameter> <parameter> <name value="match"/> <use value="out"/> <min value="1"/> <max value="*"/> <documentation value="Result for each submitted identifier. Contains either `patient` or `issue`. Clients should pair results with the request by `match.identifier`."/> <part> <name value="identifier"/> <use value="out"/> <min value="1"/> <max value="1"/> <documentation value="Identifier as submitted in the request."/> <type value="Identifier"/> </part> <part> <name value="patient"/> <use value="out"/> <min value="0"/> <max value="1"/> <documentation value="Reference to the found patient."/> <type value="Reference"/> <targetProfile value="https://fhir.ee/mpi/StructureDefinition/ee-mpi-patient"/> </part> <part> <name value="issue"/> <use value="out"/> <min value="0"/> <max value="1"/> <documentation value="OperationOutcome for this identifier: warning if patient not found, error if identifier.system is not allowed."/> <type value="OperationOutcome"/> </part> </parameter> </OperationDefinition>

Generated Narrative: OperationDefinition patient-resolve-reference

URL: [base]/Patient/$resolve-reference

Parameters

Use Name Scope Cardinality Type Binding Documentation

identifier

1..*

Patient identifier to resolve. At least one is required, and system and value are mandatory. identifier.system must be a code of the https://fhir.ee/ValueSet/patsiendi-identifikaatorite-domeen value set, or the value of that code's oid property. At most 100 identifiers per request.

OUT

match

1..*

Result for each submitted identifier. Contains either patient or issue. Clients should pair results with the request by match.identifier.

OUT

match.identifier

1..1

Identifier

Identifier as submitted in the request.

OUT

match.patient

0..1

Reference (EE MPI Patient)

Reference to the found patient.

OUT

match.issue

0..1

OperationOutcome

OperationOutcome for this identifier: warning if patient not found, error if identifier.system is not allowed.

Only POST is supported. identifier.system must be a code of the patsiendi-identifikaatorite-domeen value set, or the value of that code's oid property. An identifier without system or value fails the whole request. If the total number of identifiers exceeds 100, the whole request fails. An invalid system is returned in match.issue. Per-identifier issues do not fail the request: the response is HTTP 200 with a Parameters resource, even if every identifier has an issue.