MyHealth@Eu NCPeH API
0.0.1 - ci-build 150

MyHealth@Eu NCPeH API - Local Development build (v0.0.1) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Patient Search

Business View

The overall business scenarios are described in the Business view page

Application View

​The implementation-indipendent sequence diagrams is described in the Application view page

Implementation

The Patient Identfication is realized by performing these steps:

  • The Requesting NCP sends a Patient search request to the Responding NCP.
  • The Responding NCP searches for the requested patient(s) and returns a HL7 FHIR Bundle containing Patient resources.
  • The returned Bundle contains all matching Patient entries, based on the provided search parameters.

​Requesting NCPRequesting NCPResponding NCPResponding NCPPatient SearchPatient SearcheHDSI Patient Identification RequesteHDSI Patient Identification Response

Figure 1 - Patient Identification

eHDSI Patient Identification Request

The Requesting NCP initiates a search query for a Patient using the FHIR API:

  GET $server/Patient?<searchParameters><modifiers>

The query includes search parameters and modifiers to refine the search criteria. Details below.

Search parameters
Parameter Opt searchParameter type notes
business identifier SHOULD identifier token  
name MAY name string  
birth date MAY birthdate date  
gender MAY gender token  

Search result parameters

Consumers are suggested to explictly indicate the elements that are expected to be used for the Patient Identification and minimize the patient information exchanged, by using the _elements Search result parameter.

Modifiers

No modifers required

eHDSI Patient Identification Response

The Responding NCP processes the request and returns a FHIR Bundle containing the search results, in accordance with the rules specified in HL7 FHIR - RESTful Search) and in Search Results.

The Bundle contains entries of type Patient:

  Bundle.where(type='searchSet').entry.resource.ofType(Patient)

The Bundle of type 'searchSet' should be created

The National Infrastructure returns Patient resources conformant with the PatientMinimalMyHealthEu profile.

Parameter Opt
business identifier SHALL
name SHALL
birth date SHALL
gender SHALL

HTTP Error Response Codes

HTTP Response Description
401 Unauthorized authorization is required for the interaction that was attempted
404 Not Found resource type not supported, or not a FHIR end-point
410 Gone resource deleted or no more active

Examples

All patients with this identifier

GET $server/Patient?identifier=http://identifiers.mycountry|123456789

All patients with this identifier (only essential information returned)

GET $server/Patient?identifier=http://identifiers.mycountry|123456789&_elements=identifier,active,name,birthDate,gender

All patients with both identifiers

GET $server/Patient?identifier=http://first-id.mycountry|123456789&http://second-id.mycountry|987654321

All patients with in the name "doe" born the 1985-01-14 and of male gender

GET $server/Patient?name=doe&birthdate=eq1985-01-14&sex=male