Patients may be searched using a search request (GET). Search for claims will return a bundle including one or more FHIR items. Person search uses fuzzy search critieria and therefore may return more persons with a non-exact match.
Example for a SEARCH request for a person using name search
{{baseURL}}/{{tenant}}/Patient?given=Boehm&family=Kristian
Example: this search requests fetches all persons matching the given and family name
For an example see RED Interchange API - Postman Collection 0050 - Patient Search by Name
Data of a specific patient may be fetched using a read request (GET) with the (human readable) identifier of the specific patient. The request returns a FHIR item of type KBV_PR_AW_Patient.
Example for a READ request for a patient
{{baseURL}}/{{tenant}}/Patient/6020
Example: this read request returns the FHIR item for a the person with ID 6020. The ID may be retrieved by a search request sent before this request.
For an example see RED Interchange API - Postman Collection 0051 - Specific Patient
Example of a FHIR item for a patient
<Patient xmlns="http://hl7.org/fhir">
<id value="25bkpByVaSl0ALEZ29ZqE3JAxPZnDy8A"/>
<meta>
<versionId value="1"/>
<lastUpdated value="2023-06-14T12:57:30+00:00"/>
<profile value="https://fhir.kbv.de/StructureDefinition/KBV_PR_AW_Patient|1.2.0"/>
</meta>
<text>
<status value="extensions"/>
<div xmlns="http://www.w3.org/1999/xhtml">Patient Kristian Boehm (V1) | ID 25bkpByVaSl0ALEZ29ZqE3JAxPZnDy8A | Geschlecht männlich | Geburtsdatum 20.11.1994 | Adresse Kurfürstenstraße 85, 74394 Hessigheim | VersichertenID GKV F434984323 | zuletzt bearbeitet 2023-06-14T12:57:30+00:00</div>
</text>
<extension url="https://fhir.kbv.de/StructureDefinition/KBV_EX_AW_Patient_KostenuebernahmeIgeL">
<valueBoolean value="false"/>
</extension>
<extension url="https://fhir.kbv.de/StructureDefinition/KBV_EX_AW_Patient_Vsdm_Zusatzinformationen">
<extension url="geschlecht">
<valueCoding>
<system value="http://hl7.org/fhir/administrative-gender"/>
<code value="male"/>
</valueCoding>
</extension>
<extension url="geburtsdatum">
<valueDate value="1994-11-20"/>
</extension>
<extension url="adresse">
<valueAddress>
<type value="physical"/>
<line value="Kurfürstenstraße 85">
<extension url="http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-streetName">
<valueString value="Kurfürstenstraße"/>
</extension>
<extension url="http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-houseNumber">
<valueString value="85"/>
</extension>
</line>
<city value="Hessigheim"/>
<postalCode value="74394"/>
<country value="D"/>
</valueAddress>
</extension>
</extension>
<identifier>
<use value="usual"/>
<type>
<coding>
<system value="http://terminology.hl7.org/CodeSystem/v2-0203"/>
<code value="MR"/>
</coding>
</type>
<system value="http://www.redmedical.de/identifiers/patient"/>
<value value="6020"/>
</identifier>
<identifier>
<use value="official"/>
<type>
<coding>
<system value="http://fhir.de/CodeSystem/identifier-type-de-basis"/>
<code value="GKV"/>
</coding>
</type>
<system value="http://fhir.de/NamingSystem/gkv/kvid-10"/>
<value value="F434984323"/>
</identifier>
<active value="true"/>
<name>
<use value="official"/>
<text value="Kristian Boehm"/>
<family value="Boehm">
<extension url="http://hl7.org/fhir/StructureDefinition/humanname-own-name">
<valueString value="Boehm"/>
</extension>
</family>
<given value="Kristian"/>
</name>
<telecom>
<system value="email"/>
<value value="KristianBoehm@dayrep.com"/>
</telecom>
<telecom>
<system value="phone"/>
<value value="07143111549"/>
</telecom>
<gender value="male"/>
<birthDate value="1994-11-20"/>
<address>
<type value="both"/>
<line value="Kurfürstenstraße 85">
<extension url="http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-streetName">
<valueString value="Kurfürstenstraße"/>
</extension>
<extension url="http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-houseNumber">
<valueString value="85"/>
</extension>
</line>
<city value="Hessigheim"/>
<postalCode value="74394"/>
<country value="D"/>
</address>
<communication>
<language>
<coding>
<system value="urn:ietf:bcp:47"/>
<code value="de-DE"/>
</coding>
</language>
<preferred value="true"/>
</communication>
</Patient>
