RelatedPerson - FHIR Resource (stu3)

This RelatedPerson Resource uses the FHIR API standard for access and structure.

Validate an RelatedPerson FHIR Resource (stu3)

RelatedPerson Attributes

AttributeField is listTypeDescription

Description: The patient this person is related to

FHIR Version: stu3

Attribute Type : Reference

Required: N/A

Countability: Singleton

Flags: N/A

Terminology bindings: N/A

Requirements: N/A

Comments: N/A

Example:

"patient": {
  "reference": "Patient/example"
}

Learn more about the (RelatedPerson) patient FHIR attribute

Description: A name associated with the person

FHIR Version: stu3

Attribute Type : HumanName

Required: N/A

Countability: Array

Flags: N/A

Terminology bindings: N/A

Requirements: N/A

Comments: N/A

Example:

"name": [
  {
    "given": [
      "Bénédicte"
    ],
    "_family": {
      "extension": [
        {
          "url": "http://hl7.org/fhir/StructureDefinition/humanname-own-prefix",
          "valueString": "VV"
        }
      ]
    },
    "family": "du Marché"
  }
]

Learn more about the (RelatedPerson) name FHIR attribute

Description: The nature of the relationship

FHIR Version: stu3

Attribute Type : CodeableConcept

Required: N/A

Countability: Singleton

Flags: N/A

Terminology bindings: N/A

Requirements: N/A

Comments: N/A

Example:

"relationship": {
  "coding": [
    {
      "code": "N",
      "system": "http://hl7.org/fhir/v2/0131"
    },
    {
      "code": "WIFE",
      "system": "http://hl7.org/fhir/v3/RoleCode"
    }
  ]
}

Learn more about the (RelatedPerson) relationship FHIR attribute

Description: A contact detail for the person

FHIR Version: stu3

Attribute Type : ContactPoint

Required: N/A

Countability: Array

Flags: N/A

Terminology bindings: N/A

Requirements: N/A

Comments: N/A

Example:

"telecom": [
  {
    "system": "phone",
    "value": "+33 (237) 998327"
  }
]

Learn more about the (RelatedPerson) telecom FHIR attribute

Description: male | female | other | unknown

FHIR Version: stu3

Attribute Type : code

Required: N/A

Countability: Singleton

Flags: N/A

Terminology bindings: N/A

Requirements: N/A

Comments: N/A

Example:

"gender": "female"

Learn more about the (RelatedPerson) gender FHIR attribute

Description: Period of time that this relationship is considered valid

FHIR Version: stu3

Attribute Type : Period

Required: N/A

Countability: Singleton

Flags: N/A

Terminology bindings: N/A

Requirements: N/A

Comments: N/A

Example:

"period":

Learn more about the (RelatedPerson) period FHIR attribute

Description: The date on which the related person was born

FHIR Version: stu3

Attribute Type : date

Required: N/A

Countability: Singleton

Flags: N/A

Terminology bindings: N/A

Requirements: N/A

Comments: N/A

Example:

"birthDate":

Learn more about the (RelatedPerson) birthDate FHIR attribute

Description: Address where the related person can be contacted or visited

FHIR Version: stu3

Attribute Type : Address

Required: N/A

Countability: Array

Flags: N/A

Terminology bindings: N/A

Requirements: N/A

Comments: N/A

Example:

"address": [
  {
    "postalCode": "75004",
    "city": "Paris",
    "line": [
      "43, Place du Marché Sainte Catherine"
    ],
    "country": "FRA"
  }
]

Learn more about the (RelatedPerson) address FHIR attribute

Description: Whether this related person's record is in active use

FHIR Version: stu3

Attribute Type : boolean

Required: N/A

Countability: Singleton

Flags: N/A

Terminology bindings: N/A

Requirements: N/A

Comments: N/A

Example:

"active": true

Learn more about the (RelatedPerson) active FHIR attribute

Description: A human identifier for this person

FHIR Version: stu3

Attribute Type : Identifier

Required: N/A

Countability: Array

Flags: N/A

Terminology bindings: N/A

Requirements: N/A

Comments: N/A

Example:

"identifier": [
  {
    "use": "usual",
    "type": {
      "text": "INSEE"
    },
    "system": "urn:oid:1.2.250.1.61",
    "value": "272117510400399"
  }
]

Learn more about the (RelatedPerson) identifier FHIR attribute

Description: Image of the person

FHIR Version: stu3

Attribute Type : Attachment

Required: N/A

Countability: Array

Flags: N/A

Terminology bindings: N/A

Requirements: N/A

Comments: N/A

Example:

"photo": [
  {
    "url": "Binary/f016",
    "contentType": "image/jpeg"
  }
]

Learn more about the (RelatedPerson) photo FHIR attribute

RelatedPerson Example

{
  "patient": {
    "reference": "Patient/example"
  },
  "name": [
    {
      "given": [
        "Bénédicte"
      ],
      "_family": {
        "extension": [
          {
            "url": "http://hl7.org/fhir/StructureDefinition/humanname-own-prefix",
            "valueString": "VV"
          }
        ]
      },
      "family": "du Marché"
    }
  ],
  "relationship": {
    "coding": [
      {
        "code": "N",
        "system": "http://hl7.org/fhir/v2/0131"
      },
      {
        "code": "WIFE",
        "system": "http://hl7.org/fhir/v3/RoleCode"
      }
    ]
  },
  "resourceType": "RelatedPerson",
  "text": {
    "status": "generated",
    "div": "<div xmlns=\"http://www.w3.org/1999/xhtml\">\n      <table>\n        <tbody>\n          <tr>\n            <td>Name</td>\n            <td>Bénédicte du Marché</td>\n          </tr>\n          <tr>\n            <td>Address</td>\n            <td>43, Place du Marché Sainte Catherine, 75004 Paris, France</td>\n          </tr>\n          <tr>\n            <td>Contacts</td>\n            <td>Phone: +33 (237) 998327</td>\n          </tr>\n        </tbody>\n      </table>\n    </div>"
  },
  "address": [
    {
      "postalCode": "75004",
      "city": "Paris",
      "line": [
        "43, Place du Marché Sainte Catherine"
      ],
      "country": "FRA"
    }
  ],
  "telecom": [
    {
      "system": "phone",
      "value": "+33 (237) 998327"
    }
  ],
  "gender": "female",
  "active": true,
  "identifier": [
    {
      "use": "usual",
      "type": {
        "text": "INSEE"
      },
      "system": "urn:oid:1.2.250.1.61",
      "value": "272117510400399"
    }
  ],
  "id": "benedicte",
  "photo": [
    {
      "url": "Binary/f016",
      "contentType": "image/jpeg"
    }
  ]
}

RelatedPerson Structure


  
{
  "resourceType" : "RelatedPerson",
  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  "identifier" : [{ Identifier }], // A human identifier for this person
  "active" : <boolean>, // Whether this related person's record is in active use
  "patient" : { Reference(Patient) }, // R!  The patient this person is related to
  "relationship" : { CodeableConcept }, // The nature of the relationship
  "name" : [{ HumanName }], // A name associated with the person
  "telecom" : [{ ContactPoint }], // A contact detail for the person
  "gender" : "<code>", // male | female | other | unknown
  "birthDate" : "<date>", // The date on which the related person was born
  "address" : [{ Address }], // Address where the related person can be contacted or visited
  "photo" : [{ Attachment }], // Image of the person
  "period" : { Period } // Period of time that this relationship is considered valid
}

RelatedPerson Search Parameters

The following search parameters can be used to query RelatedPerson resources. Just submit them like so:

https://api.1up.health/fhir/stu3/RelatedPerson?query-param=queryvalue

Search Parameter	Field Type	Resource Fields Searched
`active`	`text`	`active`
`address`	`text`	`address.line, address.city, address.state, address.country, address.postalCode, address.text`
`address-city`	`text`	`address.city`
`address-country`	`text`	`address.country`
`address-postalcode`	`text`	`address.postalCode`
`address-state`	`text`	`address.state`
`address-use`	`text`	`address.use`
`birthdate`	`date`	`birthDate`
`email`	`text`	`telecom.where`
`gender`	`text`	`gender`
`identifier`	`text`	`identifier`
`name`	`text`	`name.family, name.give, name.prefix, name.suffix, name.suffix, name.text`
`patient`	`reference`	`patient`
`phone`	`text`	`telecom.where`
`phonetic`	`text`	`name`
`telecom`	`text`	`telecom`