Get Client Demographics Query

Used to query detailed demographic data corresponding to an individual patient in the PCR. This interaction occurs when the consuming system and/or user has:

  1. a unique primary (definitional) person identifier (e.g. PCR Enterprise ID (EID), Ontario health card number (HCN), medical record numbers (MRN) for standard model hospital, or corporate ID (CORPID) for a corporate model hospital); and,
  2. the registered source (i.e. OID) for the unique primary identifier.


As the receiver of the interaction request, the PCR will respond with the demographic data matching the query parameters. For example, given a primary client identifier (e.g. Ontario HCN OID & value), this service will return detailed demographic information (e.g. legal name, home address, date of birth, gender) and all active identifiers for the matched patient.


When this interaction sends a query to the PCR requesting all demographic and identification information associated with a specific person, only one primary identifier must be present as a query parameter.


Message Type








Trigger Event

Transmission Wrapper

Control Event Wrapper


PRPA_IN101101CA Get Client Demographic Query


Get Demographic Query


Request Transport Wrapper


Registry Query Request Wrapper - Human Initiated


Query by Client ID

PRPA_IN101102CA Get Client Demographic


Get Demographic


Application Ack


Registry Query


Get Demographics



Query by one of these primary IDs:

  1. PCR Enterprise ID (EID) aka Enterprise Client ID (ECID)
  1. Health Card Number (HCN)
  1. Corporate ID (CORPID) for corporate model hospitals
  1. Medical Record Number (MRN) for standard model hospitals


A source OID (ID Issuer) & corresponding ID value must be provided in the request.

For example, for PCR EID:

OID (ID Issuer) = 2.16.840.1.113883.3.239.20 (eHealth Ontario PCR Enterprise Identifier (EID))

ID = 123456



Based on exact matching the primary ID for a given active member record, return the entity view for that single client.  Response includes the entity view for that client when they have at least one active member record in the entity.  Detailed ‘golden record’ for the client is returned including the most up-to-date demographics across all active members in the entity, and all active identifiers.


Returns the following business attributes (where they exist, depending on PCR data density for the given client):

  • Ontario Health Card Number
  • Non-Ontario (Out-of-Province) Health Card Number(s)
  • Corporate ID(s)
  • Medical Record Number(s)
  • Legal Name
  • Alias Name
  • Date of Birth
  • Gender
  • Address(es):
    • Home
    • Mailing
    • Temporary
  • Phone Number(s):
    • Home
    • Work
    • Emergency
    • Other
  • Next of Kin Name
  • Primary (Communication) Language
  • Death Indicator
  • Death Date
  • Confidentiality Indicator

Sample Message

<S:Envelope xmlns:S="" xmlns:xsi="">
<S:Header xmlns:wsa="">
<PRPA_IN101101CA ITSVersion="XML_1.0" xmlns:xsi="" xmlns="urn:hl7-org:v3">
<realmCode code="CA" />
<id specializationType="II.TOKEN" root="8734B5B4-8737-4FD8-BDAC-4200B095AA0C" />
<creationTime specializationType="TS.FULLDATETIME" value="20180417170310.807-0400" />
<responseModeCode code="I" />
<versionCode code="V3-2008N" />
<interactionId specializationType="II.PUBLIC" root="2.16.840.1.113883.1.6" extension="PRPA_IN101101CA" />
<profileId root="2.16.840.1.113883.2.20.2" extension="R02.04.03" />
<profileId root="2.16.840.1.113883.3.239.7" extension="V03.00" />
<processingCode code="P" />
<processingModeCode code="T" />
<acceptAckCode code="NE" />
<receiver typeCode="RCV">
<telecom specializationType="TEL.URI" value="" />
<device classCode="DEV" determinerCode="INSTANCE">
<id specializationType="II.BUS" root="2.16.840.1.113883.3.239.2" use="BUS" />
<name mediaType="text/plain" representation="TXT">eHealth Ontario Integration Facility</name>
<agent classCode="AGNT">
<agentOrganization classCode="ORG" determinerCode="INSTANCE">
<id specializationType="II.BUS" root="2.16.840.1.113883.3.239" use="BUS" />
<sender typeCode="SND">
<telecom specializationType="TEL.URI" value="" />
<device classCode="DEV" determinerCode="INSTANCE">
<id specializationType="II.BUS" root="2.16.840.1.113883.3.239.4" extension="UniqueSenderIdentifier" use="BUS" />
<name mediaType="text/plain" representation="TXT">eHealth Ontario Portal Application</name>
<desc mediaType="text/plain" representation="TXT">I hereby accept the service agreement here:</desc>
<controlActEvent classCode="CACT" moodCode="EVN">
<id specializationType="II.BUS" root="2.16.840.1.113883." extension="52379653" use="BUS" />
<code code="PRPA_TE101101CA" codeSystem="2.16.840.1.113883.1.18" />
<statusCode code="completed" />
<low value="20180417170310.807-0400" />
<reasonCode code="PATCAR" codeSystem="2.16.840.1.113883.11.14878" />
<author typeCode="AUT" contextControlCode="AP">
<time specializationType="TS.FULLDATETIME" value="20180417170310.807-0400" />
<assignedEntity1 classCode="ASSIGNED">
<id root="" extension="5763665838" displayable="true" use="BUS" />
<assignedPerson classCode="PSN" determinerCode="INSTANCE">
<name specializationType="PN.BASIC">
<family partType="FAM">User</family>
<given partType="GIV">Test</given>
<representedOrganization classCode="ORG" determinerCode="INSTANCE">
<id specializationType="II.PUBLIC" root="" extension="123456789012" displayable="true" />
<name mediaType="text/plain" representation="TXT">Mohawk College Hospital</name>
<queryId specializationType="II.TOKEN" root="BE911500-730F-4D9F-8096-ADD985A0688B" />
<initialQuantity specializationType="INT.POS" value="10" />
<value specializationType="II.PUBLIC" root="2.16.840.1.113883." extension="1182615488" />

*a valid UniqueSenderIdentifier needs to be replaced in the example above