Get a list of related person records

get

/RelatedPerson

Retrieves related person records that meet supplied query parameters.

Note:
  • -relationship-level is required for patient and identifier searches.

  • -relationship-level can only be provided with patient or identifier.

  • -relationship-level can only be set to Patient.

This operation supports the following authorization types:

Request

Query Parameters
  • A reference to an encounter associated with the related person. This parameter is required if the identifier, _id, and patient parameters are not used.
    Example: -encounter=97697434
  • The level of relationship for the related person. This parameter is required if either of the patient or -encounter parameters are used.
    Example:
    -relationship-level=http://hl7.org/fhir/resource-types|Patient
  • The logical resource ID associated with the resource. This parameter is required if the patient, identifier, and -encounter parameters are not used.
    Example: _id=1234-5678
  • The Provenance resource entries to be returned as part of the bundle.
    • May be provided once with the Provenance:target value. Example: _revinclude=Provenance:target.
    • May be provided with the _id or patient parameters. Example: _id=214938095&_revinclude=Provenance:target.
    • When _revinclude is provided in a request to the closed endpoint, the OAuth2 token must include the scope corresponding with the authorization type, such as user/Provenance.read, patient/Provenance.read, or system/Provenance.read.
    Example: _revinclude=Provenance:target
  • A related person identifier. This parameter is required if the patient, _id, and -encounter parameters are not used. When provided, the identifier query parameter must include both a system and a code.
    Example: identifier=urn:oid:2.16.840.1.113883.3.13.6|RANDES011E8442-2E86-4A00-8394-EFC6A3434A8F
  • A reference to a patient associated with the related person. This parameter is required if the identifier, _id, and -encounter parameters are not used.
    Example: patient=14067892
Header Parameters
Back to Top

Response

Supported Media Types

Default Response

Example search by patient and -relationship-level=Patient.

Example Request:
GET https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/RelatedPerson?patient=12724066&-relationship-level=Patient
Example Response:
{
    'resourceType': 'Bundle',
    'id': '106abf01-6358-44d4-8f66-37526caa6ab4',
    'type': 'searchset',
    'total': 2,
    'link': [
      {
        'relation': 'self',
        'url': 'https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/RelatedPerson?patient=12724066'
      }
    ],
    'entry': [
      {
        'fullUrl': 'https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/RelatedPerson/12724066-12724068',
        'resource': {
          'resourceType': 'RelatedPerson',
          'id': '12724066-12724068',
          'meta': {
            'versionId': 145,
            'lastUpdated': '2021-03-22T14:12:37.000Z'
          },
          'text': {
            'status': 'extensions',
            'div': '<div xmlns="http://www.w3.org/1999/xhtml"><p><b>Related Person</b></p><p><b>Name</b>: SMART, NANCY</p><p><b>DOB</b>: Aug 11, 1980</p><p><b>Gender</b>: female</p><p><b>Patient</b>: SMART, HAILEY</p><p><b>Status</b>: Active</p><p><b>Relationship</b>: Default Guarantor</p><p><b>Relationship</b>: Child</p><p><b>Relationship</b>: Family Member</p><p><b>Relationship Level</b>: Patient</p></div>'
          },
          'extension': [
            {
              'valueCodeableConcept': {
                'coding': [
                  {
                    'system': 'http://hl7.org/fhir/resource-types',
                    'code': 'Patient',
                    'display': 'Patient'
                  }
                ],
                'text': 'Patient'
              },
              'url': 'https://fhir-ehr.cerner.com/r4/StructureDefinition/relationship-level'
            }
          ],
          'identifier': [
            {
              'id': 'CI-490060520-1',
              'use': 'usual',
              'type': {
                'coding': [
                  {
                    'system': 'https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/4',
                    'code': '22',
                    'display': 'Military Id',
                    'userSelected': true
                  }
                ],
                'text': 'Military Id'
              },
              'system': 'urn:oid:2.16.840.1.113883.3.42.10001.100001.12',
              'value': '1000000105'
            },
            {
              'id': 'CI-490068325-2',
              'use': 'usual',
              'type': {
                'coding': [
                  {
                    'system': 'https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/4',
                    'code': '2553236771',
                    'display': 'Federated Person Principal',
                    'userSelected': true
                  },
                  {
                    'system': 'http://terminology.hl7.org/CodeSystem/v2-0203',
                    'code': 'AN',
                    'display': 'Account number',
                    'userSelected': false
                  }
                ],
                'text': 'Federated Person Principal'
              },
              'system': 'urn:oid:2.16.840.1.113883.3.13.6',
              'value': 'URN:CERNER:IDENTITY-FEDERATION:REALM:EC2458F2-1E24-41C8-B71B-0E701AF7583D-CH:PRINCIPAL:RS7MH9WX3XB8VY63',
              'period': {
                'start': '2020-08-10T14:29:20.000Z'
              }
            },
            {
              'id': 'CI-490059563-3',
              'use': 'usual',
              'type': {
                'coding': [
                  {
                    'system': 'https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/4',
                    'code': '2553236771',
                    'display': 'Federated Person Principal',
                    'userSelected': true
                  },
                  {
                    'system': 'http://terminology.hl7.org/CodeSystem/v2-0203',
                    'code': 'AN',
                    'display': 'Account number',
                    'userSelected': false
                  }
                ],
                'text': 'Federated Person Principal'
              },
              'system': 'urn:oid:2.16.840.1.113883.3.13.6',
              'value': 'URN:CERNER:IDENTITY-FEDERATION:REALM:E8A84236-C258-4952-98B7-A6FF8A9C587A-CH:PRINCIPAL:RS7MH9WX3XB8VY63',
              'period': {
                'start': '2020-06-30T20:06:42.000Z'
              }
            },
            {
              'id': 'CI-490153231-4',
              'use': 'usual',
              'type': {
                'coding': [
                  {
                    'system': 'https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/4',
                    'code': '2553236785',
                    'display': 'MIllennium Person Identifier',
                    'userSelected': true
                  }
                ],
                'text': 'MIllennium Person Identifier'
              },
              'value': '12868',
              'period': {
                'start': '2020-12-18T19:15:06.000Z'
              }
            }
          ],
          'active': true,
          'patient': {
            'reference': 'Patient/12724068',
            'display': 'SMART, HAILEY'
          },
          'relationship': [
            {
              'id': 'CI-490017041-0',
              'extension': [
                {
                  'valuePeriod': {
                    'start': '2019-12-26T16:06:26.000Z'
                  },
                  'url': 'https://fhir-ehr.cerner.com/r4/StructureDefinition/period'
                },
                {
                  'valueCodeableConcept': {
                    'coding': [
                      {
                        'system': 'https://fhir.cerner.com/2c400054-42d8-4e74-87b7-80b5bd5fde9f/codeSet/40',
                        'code': '156',
                        'display': 'Mother',
                        'userSelected': true
                      },
                      {
                        'system': 'http://terminology.hl7.org/CodeSystem/v3-RoleCode',
                        'code': 'MTH',
                        'display': 'mother',
                        'userSelected': false
                      }
                    ],
                    'text': 'Mother'
                  },
                  'url': 'https://fhir-ehr.cerner.com/r4/StructureDefinition/relation'
                }
              ],
              'coding': [
                {
                  'system': 'https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/351',
                  'code': '1150',
                  'display': 'Default Guarantor',
                  'userSelected': true
                },
                {
                  'system': 'http://terminology.hl7.org/CodeSystem/v3-RoleCode',
                  'code': 'GT',
                  'display': 'Guarantor',
                  'userSelected': false
                }
              ],
              'text': 'Default Guarantor'
            },
            {
              'id': 'CI-490017055-1',
              'extension': [
                {
                  'valuePeriod': {
                    'start': '2019-12-26T16:06:26.000Z'
                  },
                  'url': 'https://fhir-ehr.cerner.com/r4/StructureDefinition/period'
                },
                {
                  'valueCodeableConcept': {
                    'coding': [
                      {
                        'system': 'https://fhir.cerner.com/2c400054-42d8-4e74-87b7-80b5bd5fde9f/codeSet/40',
                        'code': '156',
                        'display': 'Mother',
                        'userSelected': true
                      },
                      {
                        'system': 'http://terminology.hl7.org/CodeSystem/v3-RoleCode',
                        'code': 'MTH',
                        'display': 'mother',
                        'userSelected': false
                      },
                      'text': 'Mother'
                    ]
                  },
                  'url': 'https://fhir-ehr.cerner.com/r4/StructureDefinition/relation'
                }
              ],
              'coding': [
                {
                  'system': 'https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/351',
                  'code': '1153',
                  'display': 'Family Member',
                  'userSelected': true
                },
                {
                  'system': 'http://terminology.hl7.org/CodeSystem/v3-RoleCode',
                  'code': 'FAMMEMB',
                  'display': 'family member',
                  'userSelected': false
                }
              ],
              'text': 'Family Member'
            }
          ],
          'name': [
            {
              'id': 'CI-12724066-0',
              'use': 'official',
              'text': 'SMART, NANCY',
              'family': 'SMART',
              'given': [
                'NANCY'
              ],
              'period': {
                'start': '2019-12-26T15:12:34.000Z'
              }
            }
          ],
          'telecom': [
            {
              'id': 'CI-PH-29852801-0',
              'extension': [
                {
                  'valueUrl': '13215555555',
                  'url': 'http://hl7.org/fhir/StructureDefinition/iso21090-TEL-address'
                }
              ],
              'system': 'phone',
              'value': '13215555555',
              'use': 'work',
              'period': {
                'start': '2021-03-22T14:12:37.000Z'
              }
            },
            {
              'id': 'CI-PH-29811918-1',
              'extension': [
                {
                  'valueUrl': '(987)654-3210',
                  'url': 'http://hl7.org/fhir/StructureDefinition/iso21090-TEL-address'
                }
              ],
              'system': 'phone',
              'value': '9876543210',
              'use': 'home',
              'period': {
                'start': '2019-12-26T15:12:34.000Z'
              }
            },
            {
              'id': 'CI-PH-29844706-2',
              'extension': [
                {
                  'valueUrl': '(503)400-8675',
                  'url': 'http://hl7.org/fhir/StructureDefinition/iso21090-TEL-address'
                }
              ],
              'system': 'phone',
              'value': '5034008675',
              'use': 'mobile',
              'period': {
                'start': '2021-01-25T05:00:00.000Z'
              }
            },
            {
              'id': 'CI-PH-29844710-3',
              'extension': [
                {
                  'valueUrl': '5034008675',
                  'url': 'http://hl7.org/fhir/StructureDefinition/iso21090-TEL-address'
                }
              ],
              'system': 'phone',
              'value': '5034008675',
              'use': 'mobile',
              'period': {
                'start': '2021-01-25T05:00:00.000Z'
              }
            },
            {
              'id': 'CI-PH-29844690-4',
              'extension': [
                {
                  'valueUrl': '5034008675',
                  'url': 'http://hl7.org/fhir/StructureDefinition/iso21090-TEL-address'
                }
              ],
              'system': 'phone',
              'value': '5034008675',
              'use': 'mobile',
              'period': {
                'start': '2021-01-25T05:00:00.000Z'
              }
            },
            {
              'id': 'CI-PH-29844708-5',
              'extension': [
                {
                  'valueUrl': '5034008675',
                  'url': 'http://hl7.org/fhir/StructureDefinition/iso21090-TEL-address'
                }
              ],
              'system': 'phone',
              'value': '5034008675',
              'use': 'mobile',
              'period': {
                'start': '2021-01-25T05:00:00.000Z'
              }
            },
            {
              'id': 'CI-PH-29844688-6',
              'extension': [
                {
                  'valueUrl': '5034008675',
                  'url': 'http://hl7.org/fhir/StructureDefinition/iso21090-TEL-address'
                }
              ],
              'system': 'phone',
              'value': '5034008675',
              'use': 'mobile',
              'period': {
                'start': '2021-01-25T00:33:18.000Z'
              }
            },
            {
              'id': 'CI-EM-29822894-0',
              'system': 'email',
              'value': 'workemail@gmail.com',
              'use': 'home',
              'period': {
                'start': '2020-06-30T19:47:10.000Z'
              }
            }
          ],
          'gender': 'female',
          'birthDate': '1980-08-11',
          'address': [
            {
              'id': 'CI-24313551-0',
              'use': 'home',
              'text': '3P\nKANSAS CITY, MO 641510001\nUS',
              'line': [
                '3P'
              ],
              'city': 'KANSAS CITY',
              'district': 'Jackson',
              'state': 'MO',
              'postalCode': '641510001',
              'country': 'US',
              'period': {
                'start': '2020-12-08T15:05:44.000Z'
              }
            }
          ],
          'communication': [
            {
              'language': {
                'coding': [
                  {
                    'system': 'https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/36',
                    'code': '151',
                    'display': 'English',
                    'userSelected': true
                  },
                  {
                    'system': 'urn:ietf:bcp:47',
                    'code': 'en',
                    'display': 'English',
                    'userSelected': false
                  }
                ],
                'text': 'English'
              },
              'preferred': 'true'
            }
          ]
        }
      },
      {
        'fullUrl': 'https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/RelatedPerson/12724066-12724069',
        'resource': {
          'resourceType': 'RelatedPerson',
          'id': '12724066-12724069',
          'meta': {
            'versionId': 145,
            'lastUpdated': '2021-03-22T14:12:37.000Z'
          },
          'text': {
            'status': 'extensions',
            'div': '<div xmlns=\"http://www.w3.org/1999/xhtml\"><p><b>Related Person</b></p><p><b>Name</b>: SMART, NANCY</p><p><b>DOB</b>: Aug 11, 1980</p><p><b>Gender</b>: female</p><p><b>Patient</b>: SMART, TIMMY</p><p><b>Status</b>: Active</p><p><b>Relationship</b>: Authorized Representative</p><p><b>Relationship</b>: Default Guarantor</p><p><b>Relationship</b>: Child</p><p><b>Relationship</b>: Family Member</p><p><b>Relationship Level</b>: Patient</p></div>'
          },
          'extension': [
            {
              'valueCodeableConcept': {
                'coding': [
                  {
                    'system': 'http://hl7.org/fhir/resource-types',
                    'code': 'Patient',
                    'display': 'Patient'
                  }
                ],
                'text': 'Patient'
              },
              'url': 'https://fhir-ehr.cerner.com/r4/StructureDefinition/relationship-level'
            }
          ],
          'identifier': [
            {
              'id': 'CI-490060520-1',
              'use': 'usual',
              'type': {
                'coding': [
                  {
                    'system': 'https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/4',
                    'code': '22',
                    'display': 'Military Id',
                    'userSelected': true
                  }
                ],
                'text': 'Military Id'
              },
              'system': 'urn:oid:2.16.840.1.113883.3.42.10001.100001.12',
              'value': '1000000105'
            },
            {
              'id': 'CI-490068325-2',
              'use': 'usual',
              'type': {
                'coding': [
                  {
                    'system': 'https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/4',
                    'code': '2553236771',
                    'display': 'Federated Person Principal',
                    'userSelected': true
                  },
                  {
                    'system': 'http://terminology.hl7.org/CodeSystem/v2-0203',
                    'code': 'AN',
                    'display': 'Account number',
                    'userSelected': false
                  }
                ],
                'text': 'Federated Person Principal'
              },
              'system': 'urn:oid:2.16.840.1.113883.3.13.6',
              'value': 'URN:CERNER:IDENTITY-FEDERATION:REALM:EC2458F2-1E24-41C8-B71B-0E701AF7583D-CH:PRINCIPAL:RS7MH9WX3XB8VY63',
              'period': {
                'start': '2020-08-10T14:29:20.000Z'
              }
            },
            {
              'id': 'CI-490059563-3',
              'use': 'usual',
              'type': {
                'coding': [
                  {
                    'system': 'https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/4',
                    'code': '2553236771',
                    'display': 'Federated Person Principal',
                    'userSelected': true
                  },
                  {
                    'system': 'http://terminology.hl7.org/CodeSystem/v2-0203',
                    'code': 'AN',
                    'display': 'Account number',
                    'userSelected': false
                  }
                ],
                'text': 'Federated Person Principal'
              },
              'system': 'urn:oid:2.16.840.1.113883.3.13.6',
              'value': 'URN:CERNER:IDENTITY-FEDERATION:REALM:E8A84236-C258-4952-98B7-A6FF8A9C587A-CH:PRINCIPAL:RS7MH9WX3XB8VY63',
              'period': {
                'start': '2020-06-30T20:06:42.000Z'
              }
            },
            {
              'id': 'CI-490153231-4',
              'use': 'usual',
              'type': {
                'coding': [
                  {
                    'system': 'https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/4',
                    'code': '2553236785',
                    'display': 'MIllennium Person Identifier',
                    'userSelected': true
                  }
                ],
                'text': 'MIllennium Person Identifier'
              },
              'value': '12868',
              'period': {
                'start': '2020-12-18T19:15:06.000Z'
              }
            }
          ],
          'active': true,
          'patient': {
            'reference': 'Patient/12724069',
            'display': 'SMART, TIMMY'
          },
          'relationship': [
            {
              'id': 'CI-490068369-0',
              'extension': [
                {
                  'valuePeriod': {
                    'start': '2020-08-10T16:37:51.000Z'
                  },
                  'url': 'https://fhir-ehr.cerner.com/r4/StructureDefinition/period'
                },
                {
                  'valueCodeableConcept': {
                    'coding': [
                      {
                        'system': 'https://fhir.cerner.com/2c400054-42d8-4e74-87b7-80b5bd5fde9f/codeSet/40',
                        'code': '156',
                        'display': 'Mother',
                        'userSelected': true
                      },
                      {
                        'system': 'http://terminology.hl7.org/CodeSystem/v3-RoleCode',
                        'code': 'MTH',
                        'display': 'mother',
                        'userSelected': false
                      }
                    ],
                    'text': 'Mother'
                  },
                  'url': 'https://fhir-ehr.cerner.com/r4/StructureDefinition/relation'
                }
              ],
              'coding': [
                {
                  'system': 'https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/351',
                  'code': '2553243305',
                  'display': 'Authorized Representative',
                  'userSelected': true
                }
              ],
              'text': 'Authorized Representative'
            },
            {
              'id': 'CI-490017075-1',
              'extension': [
                {
                  'valuePeriod': {
                    'start': '2019-12-26T16:09:36.000Z'
                  },
                  'url': 'https://fhir-ehr.cerner.com/r4/StructureDefinition/period'
                },
                {
                  'valueCodeableConcept': {
                    'coding': [
                      {
                        'system': 'https://fhir.cerner.com/2c400054-42d8-4e74-87b7-80b5bd5fde9f/codeSet/40',
                        'code': '156',
                        'display': 'Mother',
                        'userSelected': true
                      },
                      {
                        'system': 'http://terminology.hl7.org/CodeSystem/v3-RoleCode',
                        'code': 'MTH',
                        'display': 'mother',
                        'userSelected': false
                      }
                    ],
                    'text': 'Mother'
                  },
                  'url': 'https://fhir-ehr.cerner.com/r4/StructureDefinition/relation'
                }
              ],
              'coding': [
                {
                  'system': 'https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/351',
                  'code': '1150',
                  'display': 'Default Guarantor',
                  'userSelected': true
                },
                {
                  'system': 'http://terminology.hl7.org/CodeSystem/v3-RoleCode',
                  'code': 'GT',
                  'display': 'Guarantor',
                  'userSelected': false
                }
              ],
              'text': 'Default Guarantor'
            },
            {
              'id': 'CI-490068372-2',
              'extension': [
                {
                  'valuePeriod': {
                    'start': '2020-08-10T16:37:51.000Z'
                  },
                  'url': 'https://fhir-ehr.cerner.com/r4/StructureDefinition/period'
                },
                {
                  'valueCodeableConcept': {
                    'coding': [
                      {
                        'system': 'https://fhir.cerner.com/2c400054-42d8-4e74-87b7-80b5bd5fde9f/codeSet/40',
                        'code': '152'
                      }
                    ]
                  },
                  'url': 'https://fhir-ehr.cerner.com/r4/StructureDefinition/relation'
                }
              ],
              'coding': [
                {
                  'system': 'https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/351',
                  'code': '1153',
                  'display': 'Family Member',
                  'userSelected': true
                },
                {
                  'system': 'http://terminology.hl7.org/CodeSystem/v3-RoleCode',
                  'code': 'FAMMEMB',
                  'display': 'family member',
                  'userSelected': false
                }
              ],
              'text': 'Family Member'
            }
          ],
          'name': [
            {
              'id': 'CI-12724066-0',
              'use': 'official',
              'text': 'SMART, NANCY',
              'family': 'SMART',
              'given': [
                'NANCY'
              ],
              'period': {
                'start': '2019-12-26T15:12:34.000Z'
              }
            }
          ],
          'telecom': [
            {
              'id': 'CI-PH-29852801-0',
              'extension': [
                {
                  'valueUrl': '13215555555',
                  'url': 'http://hl7.org/fhir/StructureDefinition/iso21090-TEL-address'
                }
              ],
              'system': 'phone',
              'value': '13215555555',
              'use': 'work',
              'period': {
                'start': '2021-03-22T14:12:37.000Z'
              }
            },
            {
              'id': 'CI-PH-29811918-1',
              'extension': [
                {
                  'valueUrl': '(987)654-3210',
                  'url': 'http://hl7.org/fhir/StructureDefinition/iso21090-TEL-address'
                }
              ],
              'system': 'phone',
              'value': '9876543210',
              'use': 'home',
              'period': {
                'start': '2019-12-26T15:12:34.000Z'
              }
            },
            {
              'id': 'CI-PH-29844706-2',
              'extension': [
                {
                  'valueUrl': '(503)400-8675',
                  'url': 'http://hl7.org/fhir/StructureDefinition/iso21090-TEL-address'
                }
              ],
              'system': 'phone',
              'value': '5034008675',
              'use': 'mobile',
              'period': {
                'start': '2021-01-25T05:00:00.000Z'
              }
            },
            {
              'id': 'CI-PH-29844710-3',
              'extension': [
                {
                  'valueUrl': '5034008675',
                  'url': 'http://hl7.org/fhir/StructureDefinition/iso21090-TEL-address'
                }
              ],
              'system': 'phone',
              'value': '5034008675',
              'use': 'mobile',
              'period': {
                'start': '2021-01-25T05:00:00.000Z'
              }
            },
            {
              'id': 'CI-PH-29844690-4',
              'extension': [
                {
                  'valueUrl': '5034008675',
                  'url': 'http://hl7.org/fhir/StructureDefinition/iso21090-TEL-address'
                }
              ],
              'system': 'phone',
              'value': '5034008675',
              'use': 'mobile',
              'period': {
                'start': '2021-01-25T05:00:00.000Z'
              }
            },
            {
              'id': 'CI-PH-29844708-5',
              'extension': [
                {
                  'valueUrl': '5034008675',
                  'url': 'http://hl7.org/fhir/StructureDefinition/iso21090-TEL-address'
                }
              ],
              'system': 'phone',
              'value': '5034008675',
              'use': 'mobile',
              'period': {
                'start': '2021-01-25T05:00:00.000Z'
              }
            },
            {
              'id': 'CI-PH-29844688-6',
              'extension': [
                {
                  'valueUrl': '5034008675',
                  'url': 'http://hl7.org/fhir/StructureDefinition/iso21090-TEL-address'
                }
              ],
              'system': 'phone',
              'value': '5034008675',
              'use': 'mobile',
              'period': {
                'start': '2021-01-25T00:33:18.000Z'
              }
            },
            {
              'id': 'CI-EM-29822894-0',
              'system': 'email',
              'value': 'workemail@gmail.com',
              'use': 'home',
              'period': {
                'start': '2020-06-30T19:47:10.000Z'
              }
            }
          ],
          'gender': 'female',
          'birthDate': '1980-08-11',
          'address': [
            {
              'id': 'CI-24313551-0',
              'use': 'home',
              'text': '3P\nKANSAS CITY, MO 641510001\nUS',
              'line': [
                '3P'
              ],
              'city': 'KANSAS CITY',
              'district': 'Jackson',
              'state': 'MO',
              'postalCode': '641510001',
              'country': 'US',
              'period': {
                'start': '2020-12-08T15:05:44.000Z'
              }
            }
          ],
          'communication': [
            {
              'language': {
                'coding': [
                  {
                    'system': 'https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/36',
                    'code': '151',
                    'display': 'English',
                    'userSelected': true
                  },
                  {
                    'system': 'urn:ietf:bcp:47',
                    'code': 'en',
                    'display': 'English',
                    'userSelected': false
                  }
                ],
                'text': 'English'
              },
              'preferred': 'true'
            }
          ]
        }
      }
    ]
  }
Headers
  • Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, provide the X-Request-Id, if present.
  • Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, provide the opc-Request-Id, if present.

x-search-by-encounter Response

Example search by -encounter.

Example Request:
GET https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/RelatedPerson?-encounter=97697434
Example Response:
{
    'resourceType': 'Bundle',
    'id': '8de80541-8f9c-4168-a308-bce0c576e945',
    'type': 'searchset',
    'total': 1,
    'link': [
      {
        'relation': 'self',
        'url': 'https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/RelatedPerson?-encounter=97697434'
      }
    ],
    'entry': [
      {
        'fullUrl': 'https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/RelatedPerson/E-12457994-97697434',
        'resource': {
          'resourceType': 'RelatedPerson',
          'id': 'E-12457994-97697434',
          'meta': {
            'versionId': '21',
            'lastUpdated': '2018-10-30T14:17:47.000Z'
          },
          'text': {
            'status': 'extensions',
            'div': '<div xmlns=\"http://www.w3.org/1999/xhtml\"><p><b>Related Person</b></p><p><b>Name</b>:MATERNITY, TESTTHREE</p><p><b>DOB</b>: Jun 20, 1987</p><p><b>Gender</b>:female</p><p><b>Patient</b>: NEWBORN, TESTTHREE</p><p><b>Status</b>:Active</p><p><b>Relationship</b>: Default Guarantor</p><p><b>Relationship</b>:Child</p><p><b>Relationship Level</b>: Encounter</p><p><b>Encounter</b>: 97697434</p></div>'
          },
          'extension': [
            {
              'valueReference': {
                'reference': 'Encounter/97697434'
              },
              'url': 'https://fhir-ehr.cerner.com/r4/StructureDefinition/related-person-encounter'
            },
            {
              'valueCodeableConcept': {
                'coding': [
                  {
                    'system': 'http://hl7.org/fhir/resource-types',
                    'code': 'Encounter',
                    'display': 'Encounter'
                  }
                ],
                'text': 'Encounter'
              },
              'url': 'https://fhir-ehr.cerner.com/r4/StructureDefinition/relationship-level'
            }
          ],
          'active': true,
          'patient': {
            'reference': 'Patient/12457995',
            'display': 'NEWBORN, TESTTHREE'
          },
          'relationship': [
            {
              'id': 'CI-97982588-0',
              'extension': [
                {
                  'valuePeriod': {
                    'start': '2016-12-08T21:53:53.000Z'
                  },
                  'url': 'https://fhir-ehr.cerner.com/r4/StructureDefinition/period'
                },
                {
                  'valueCodeableConcept': {
                    'coding': [
                      {
                        'system': 'https://fhir.cerner.com/2c400054-42d8-4e74-87b7-80b5bd5fde9f/codeSet/40',
                        'code': '156',
                        'display': 'Mother',
                        'userSelected': true
                      },
                      {
                        'system': 'http://terminology.hl7.org/CodeSystem/v3-RoleCode',
                        'code': 'MTH',
                        'display': 'mother',
                        'userSelected': false
                      }
                    ],
                    'text': 'Mother'
                  },
                  'url': 'https://fhir-ehr.cerner.com/r4/StructureDefinition/relation'
                }
              ],
              'coding': [
                {
                  'system': 'https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/351',
                  'code': '1150',
                  'display': 'Default Guarantor',
                  'userSelected': true
                },
                {
                  'system': 'http://terminology.hl7.org/CodeSystem/v3-RoleCode',
                  'code': 'GT',
                  'display': 'Guarantor',
                  'userSelected': false
                }
              ],
              'text': 'Default Guarantor'
            }
          ],
          'name': [
            {
              'id': 'CI-12457994-0',
              'use': 'official',
              'text': 'MATERNITY, TESTTHREE',
              'family': 'MATERNITY',
              'given': [
                'TESTTHREE'
              ],
              'period': {
                'start': '2016-12-08T21:28:22.000Z'
              }
            }
          ],
          'telecom': [
            {
              'id': 'CI-PH-29583893-0',
              'extension': [
                {
                  'valueUrl': '816-888-8886',
                  'url': 'http://hl7.org/fhir/StructureDefinition/iso21090-TEL-address'
                }
              ],
              'system': 'phone',
              'value': '4264758753',
              'use': 'home',
              'period': {
                'start': '2016-12-08T21:28:22.000Z'
              }
            }
          ],
          'gender': 'female',
          'birthDate': '1987-06-20',
          'address': [
            {
              'id': 'CI-24079465-0',
              'use': 'home',
              'text': '3343 Genessee St\nKansas City, MO 64111\nUS',
              'line': [
                '3343 Genessee St'
              ],
              'city': 'Kansas City',
              'state': 'MO',
              'postalCode': '64111',
              'country': 'US',
              'period': {
                'start': '2016-12-08T21:05:59.000Z'
              }
            }
          ],
          'communication': [
            {
              'language': {
                'coding': [
                  {
                    'system': 'https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/36',
                    'code': '151',
                    'display': 'English',
                    'userSelected': true
                  },
                  {
                    'system': 'urn:ietf:bcp:47',
                    'code': 'en',
                    'display': 'English',
                    'userSelected': false
                  }
                ],
                'text': 'English'
              },
              'preferred': 'true'
            }
          ]
        }
      }
    ]
  }
Headers
  • Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, provide the X-Request-Id, if present.
  • Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, provide the opc-Request-Id, if present.

x-search-with-_revinclude Response

Example search by _id using _revinclude.
Example Request:
GET https://fhir-ehr.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/RelatedPerson?_id=12510003-12541997&_revinclude=Provenance:target
Example Response:
{
    'resourceType': 'Bundle',
    'id': '1d559294-3824-45c4-b5d8-b516e538e9ea',
    'type': 'searchset',
    'total': 1,
    'link': [
      {
        'relation': 'self',
        'url': 'https://fhir-ehr.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/RelatedPerson?_id=12510003-12541997&_revinclude=Provenance%3Atarget'
      }
    ],
    'entry': [
      {
        'fullUrl': 'https://fhir-ehr.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/RelatedPerson/12510003-12541997',
        'resource': {
          'resourceType': 'RelatedPerson',
          'id': '12510003-12541997',
          'meta': {
            'versionId': '52',
            'lastUpdated': '2019-08-28T21:37:08.000Z'
          },
          'text': {
            'status': 'extensions',
            'div': '<div xmlns="http://www.w3.org/1999/xhtml"><p><b>Related Person</b></p><p><b>Name</b>: ZZTEST, BRIAN</p><p><b>DOB</b>: Nov 17, 1987</p><p><b>Gender</b>: male</p><p><b>Patient</b>: ZZTEST, MSPQ</p><p><b>Status</b>: Active</p><p><b>Relationship Level</b>: Patient</p></div>'
          },
          'extension': [
            {
              'valueCodeableConcept': {
                'coding': [
                  {
                    'system': 'http://hl7.org/fhir/resource-types',
                    'code': 'Patient',
                    'display': 'Patient'
                  }
                ],
                'text': 'Patient'
              },
              'url': 'https://fhir-ehr.cerner.com/r4/StructureDefinition/relationship-level'
            }
          ],
          'active': true,
          'patient': {
            'reference': 'Patient/12541997',
            'display': 'ZZTEST, MSPQ'
          },
          'name': [
            {
              'id': 'CI-12510003-0',
              'use': 'official',
              'text': 'ZZTEST, BRIAN',
              'family': 'ZZTEST',
              'given': [
                'BRIAN'
              ],
              'period': {
                'start': '2017-02-28T17:26:34.000Z'
              }
            }
          ],
          'telecom': [
            {
              'id': 'CI-PH-29677883-0',
              'extension': [
                {
                  'valueUrl': '(651) 321-3513',
                  'url': 'http://hl7.org/fhir/StructureDefinition/iso21090-TEL-address'
                }
              ],
              'system': 'phone',
              'value': '6513213513',
              'use': 'home',
              'period': {
                'start': '2018-01-03T15:17:13.000Z'
              }
            }
          ],
          'gender': 'male',
          'birthDate': '1987-11-17',
          'address': [
            {
              'id': 'CI-24109485-0',
              'use': 'home',
              'text': '123 TEST STREET\nKANSAS CITY, MO 64089\nUSA',
              'line': [
                '123 TEST STREET'
              ],
              'city': 'KANSAS CITY',
              'state': 'MO',
              'postalCode': '64089',
              'country': 'USA',
              'period': {
                'start': '2017-02-28T17:22:36.000Z'
              }
            }
          ],
          'communication': [
            {
              'language': {
                'coding': [
                  {
                    'system': 'https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/36',
                    'code': '151',
                    'display': 'English',
                    'userSelected': true
                  },
                  {
                    'system': 'urn:ietf:bcp:47',
                    'code': 'en',
                    'display': 'English',
                    'userSelected': false
                  }
                ],
                'text': 'English'
              },
              'preferred': true
            }
          ]
        },
        'search': {
          'mode': 'match'
        }
      },
      {
        'fullUrl': 'https://fhir-ehr.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Provenance/REL-12541997-INT.ptntdemo-12510003',
        'resource': {
          'resourceType': 'Provenance',
          'id': 'REL-12541997-INT.ptntdemo-12510003',
          'meta': {
            'versionId': '12510003',
            'lastUpdated': '2019-08-28T21:37:08Z'
          },
          'text': {
            'status': 'generated',
            'div': '<div xmlns="http://www.w3.org/1999/xhtml"><p><b>Provenance</b></p><p><b>Target</b>:</p><ul><li>RelatedPerson/12510003-12541997</li></ul><p><b>Recorded</b>: Aug 28, 2019  4:37 P.M. CDT</p><p><b>Agents</b>:</p><dl><dt>Cerner Test, Nurse Cerner</dt><dd><b>Agent Type</b>: Author</dd><dd><b>Agent Role</b>: Source</dd><dt>Default Prov Org</dt><dd><b>Agent Type</b>: Author</dd><dd><b>Agent Role</b>: Source</dd></dl></div>'
          },
          'target': [
            {
              'reference': 'RelatedPerson/12510003-12541997'
            }
          ],
          'recorded': '2019-08-28T21:37:08Z',
          'agent': [
            {
              'type': {
                'coding': [
                  {
                    'system': 'http://terminology.hl7.org/CodeSystem/provenance-participant-type',
                    'code': 'author'
                  }
                ],
                'text': 'Author'
              },
              'role': [
                {
                  'coding': [
                    {
                      'system': 'http://terminology.hl7.org/CodeSystem/contractsignertypecodes',
                      'code': 'SOURCE'
                    }
                  ],
                  'text': 'Source'
                }
              ],
              'who': {
                'reference': 'Practitioner/607928',
                'display': 'Cerner Test, Nurse Cerner'
              },
              'onBehalfOf': {
                'reference': 'Organization/3398035',
                'display': 'Default Prov Org'
              }
            },
            {
              'type': {
                'coding': [
                  {
                    'system': 'http://terminology.hl7.org/CodeSystem/provenance-participant-type',
                    'code': 'author'
                  }
                ],
                'text': 'Author'
              },
              'role': [
                {
                  'coding': [
                    {
                      'system': 'http://terminology.hl7.org/CodeSystem/contractsignertypecodes',
                      'code': 'SOURCE'
                    }
                  ],
                  'text': 'Source'
                }
              ],
              'who': {
                'reference': 'Organization/3398035',
                'display': 'Default Prov Org'
              }
            }
          ]
        },
        'search': {
          'mode': 'include'
        }
      }
    ]
  }
Headers
  • Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, provide the X-Request-Id, if present.
  • Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, provide the opc-Request-Id, if present.
Back to Top