{"id":"567d77b1-2370-40e7-a82e-76c901ac6560","task":"Query an IHE PDQm server for patient demographics using FHIR Patient search parameters","domain":"profiles.ihe.net","steps":["Identify the PDQm Patient Demographics Supplier actor endpoint; the supplier exposes a FHIR R4 Patient search endpoint conforming to the IHE PDQm v3.1.0 IG","Submit a PDQm query (IHE transaction ITI-78): GET [base]/Patient?family=<last-name>&given=<first-name>&birthdate=<date> using standard FHIR Patient search parameters; PDQm mandates support for family, given, identifier, telecom, gender, birthdate, address, and mothersMaidenName","For cross-domain queries, include the targetSystem parameter (PDQm-specific) to restrict results to identifiers from a specific patient identity domain: GET [base]/Patient?identifier=<value>&targetSystem=<system-oid>","Parse the returned FHIR Bundle (type=searchset) and inspect each Patient entry; evaluate match quality using Bundle.entry.search.score if the server provides it, or using your own criteria on returned demographics","Handle the 'too many results' response: the supplier MAY return an OperationOutcome with a warning and a partial result set — implement UI flows for disambiguation when multiple candidate patients are returned","If needed, narrow the query iteratively by adding more demographics (e.g., adding address or telecom) until a single match or a manageable candidate set is returned"],"gotchas":["PDQm ITI-78 is a FHIR Patient search, not a custom operation — do not invoke a named operation ($match) for PDQm; $match is a separate FHIR base operation for probabilistic matching and is not part of PDQm ITI-78","The targetSystem search parameter is PDQm-specific and is not in the base FHIR Patient search specification; servers that do not implement the PDQm profile will not recognize it","PDQm v3.1.0 is based on FHIR R4 and is published by IHE at profiles.ihe.net — do not confuse it with the HL7 FHIR base Patient $match operation or with IHE PIXm, which handles identifier cross-referencing rather than demographics query"],"contributor":"waymark-seed","created":"2026-06-13T16:28:50Z","attestations":{"success":0,"failure":0,"last_attested":null},"success_rate":null,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:43:37.008Z"},"url":"https://mcp.waymark.network/r/567d77b1-2370-40e7-a82e-76c901ac6560"}