Integrated Campaign Registry (ICR) Implementation Guide
0.1.0 - ci-build
Integrated Campaign Registry (ICR) Implementation Guide - Local Development build (v0.1.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions
| Official URL: https://icr.healthcampaigns.org/ValueSet/icr-relationship-to-head | Version: 0.1.0 | |||
| Draft as of 2026-10-29 | Computable Name: ICRRelationshipToHeadVS | |||
How a household member relates to the household's reference head — the question census and DHS household rosters ask. The three ICR codes (head, co-head, non-relative), the HL7 v3 RoleCode categories with their descendants (spouse, child, child-in-law, grandchild, parent, parent-in-law, sibling, adopted / foster / stepchild), v3 FAMMEMB for other relatives (code only; it is broader than the census 'other relative', so keep the source category in text where it matters) and v3 NullFlavor UNK for don't know. Binding: extensible on the relationship-to-head extension.
References
This value set includes codes based on the following rules:
https://icr.healthcampaigns.org/CodeSystem/icr-household-relationship-cs version 📦0.1.0| Code | Display | Definition |
| head | Head (reference person) | The household's reference head: the one member every other member's relationship code is relative to. At most one active member per household (icr-du-one-head). |
| co-head | Co-head | Another head of the household beside the reference head. The co-head's own relationship to the reference head is not recorded in this version. |
| non-relative | Not related | A household member not related to the reference head (lodger, domestic worker, unrelated dependant). |
http://terminology.hl7.org/CodeSystem/v3-RoleCode version 📍4.0.0 where concept is-a SPShttp://terminology.hl7.org/CodeSystem/v3-RoleCode version 📍4.0.0 where concept is-a CHILDhttp://terminology.hl7.org/CodeSystem/v3-RoleCode version 📍4.0.0 where concept is-a CHLDINLAWhttp://terminology.hl7.org/CodeSystem/v3-RoleCode version 📍4.0.0 where concept is-a GRNDCHILDhttp://terminology.hl7.org/CodeSystem/v3-RoleCode version 📍4.0.0 where concept is-a PRNhttp://terminology.hl7.org/CodeSystem/v3-RoleCode version 📍4.0.0 where concept is-a PRNINLAWhttp://terminology.hl7.org/CodeSystem/v3-RoleCode version 📍4.0.0 where concept is-a SIBhttp://terminology.hl7.org/CodeSystem/v3-RoleCode version 📍4.0.0 where concept is-a CHLDADOPThttp://terminology.hl7.org/CodeSystem/v3-RoleCode version 📍4.0.0 where concept is-a CHLDFOSThttp://terminology.hl7.org/CodeSystem/v3-RoleCode version 📍4.0.0 where concept is-a STPCHLDhttp://terminology.hl7.org/CodeSystem/v3-RoleCode version 📍4.0.0
| Code | Display | Definition |
| FAMMEMB | family member | A relationship between two people characterizing their "familial" relationship |
http://terminology.hl7.org/CodeSystem/v3-NullFlavor version 📍4.0.0
| Code | Display | Definition |
| UNK | unknown | **Description:**A proper value is applicable, but not known. **Usage Notes**: This means the actual value is not known. If the only thing that is unknown is how to properly express the value in the necessary constraints (value set, datatype, etc.), then the OTH or UNC flavor should be used. No properties should be included for a datatype with this property unless: 1. Those properties themselves directly translate to a semantic of "unknown". (E.g. a local code sent as a translation that conveys 'unknown') 2. Those properties further qualify the nature of what is unknown. (E.g. specifying a use code of "H" and a URL prefix of "tel:" to convey that it is the home phone number that is unknown.) |
Expansion performed internally based on:
This value set contains 72 concepts
| System | Code | Display (en) | Inactive | Definition | status | JSON | XML |
https://icr.healthcampaigns.org/CodeSystem/icr-household-relationship-cs | head | Head (reference person) | The household's reference head: the one member every other member's relationship code is relative to. At most one active member per household (icr-du-one-head). | ||||
https://icr.healthcampaigns.org/CodeSystem/icr-household-relationship-cs | co-head | Co-head | Another head of the household beside the reference head. The co-head's own relationship to the reference head is not recorded in this version. | ||||
https://icr.healthcampaigns.org/CodeSystem/icr-household-relationship-cs | non-relative | Not related | A household member not related to the reference head (lodger, domestic worker, unrelated dependant). | ||||
http://terminology.hl7.org/CodeSystem/v3-RoleCode | SPS | spouse | The player of the role is a marriage partner of the scoping person. | ||||
http://terminology.hl7.org/CodeSystem/v3-RoleCode | HUSB | husband | The player of the role is a man joined to a woman (scoping person) in marriage. | ||||
http://terminology.hl7.org/CodeSystem/v3-RoleCode | WIFE | wife | The player of the role is a woman joined to a man (scoping person) in marriage. | ||||
http://terminology.hl7.org/CodeSystem/v3-RoleCode | CHILD | child | The player of the role is a child of the scoping entity. | ||||
http://terminology.hl7.org/CodeSystem/v3-RoleCode | CHLDADOPT | adopted child | The player of the role is a child taken into a family through legal means and raised by the scoping person (parent) as his or her own child. | ||||
http://terminology.hl7.org/CodeSystem/v3-RoleCode | DAUADOPT | adopted daughter | The player of the role is a female child taken into a family through legal means and raised by the scoping person (parent) as his or her own child. | ||||
http://terminology.hl7.org/CodeSystem/v3-RoleCode | SONADOPT | adopted son | The player of the role is a male child taken into a family through legal means and raised by the scoping person (parent) as his or her own child. | ||||
http://terminology.hl7.org/CodeSystem/v3-RoleCode | CHLDFOST | foster child | The player of the role is a child receiving parental care and nurture from the scoping person (parent) but not related to him or her through legal or blood ties. | ||||
http://terminology.hl7.org/CodeSystem/v3-RoleCode | DAUFOST | foster daughter | The player of the role is a female child receiving parental care and nurture from the scoping person (parent) but not related to him or her through legal or blood ties. | ||||
http://terminology.hl7.org/CodeSystem/v3-RoleCode | SONFOST | foster son | The player of the role is a male child receiving parental care and nurture from the scoping person (parent) but not related to him or her through legal or blood ties. | ||||
http://terminology.hl7.org/CodeSystem/v3-RoleCode | DAUC | daughter | Description: The player of the role is a female child (of any type) of scoping entity (parent) | ||||
http://terminology.hl7.org/CodeSystem/v3-RoleCode | DAU | natural daughter | The player of the role is a female offspring of the scoping entity (parent). | ||||
http://terminology.hl7.org/CodeSystem/v3-RoleCode | STPDAU | stepdaughter | The player of the role is a daughter of the scoping person's spouse by a previous union. | ||||
http://terminology.hl7.org/CodeSystem/v3-RoleCode | NCHILD | natural child | The player of the role is an offspring of the scoping entity as determined by birth. | ||||
http://terminology.hl7.org/CodeSystem/v3-RoleCode | SON | natural son | The player of the role is a male offspring of the scoping entity (parent). | ||||
http://terminology.hl7.org/CodeSystem/v3-RoleCode | SONC | son | Description: The player of the role is a male child (of any type) of scoping entity (parent) | ||||
http://terminology.hl7.org/CodeSystem/v3-RoleCode | STPSON | stepson | The player of the role is a son of the scoping person's spouse by a previous union. | ||||
http://terminology.hl7.org/CodeSystem/v3-RoleCode | STPCHLD | step child | The player of the role is a child of the scoping person's spouse by a previous union. | ||||
http://terminology.hl7.org/CodeSystem/v3-RoleCode | CHLDINLAW | child-in-law | The player of the role is the spouse of scoping person's child. | ||||
http://terminology.hl7.org/CodeSystem/v3-RoleCode | DAUINLAW | daughter in-law | The player of the role is the wife of scoping person's son. | ||||
http://terminology.hl7.org/CodeSystem/v3-RoleCode | SONINLAW | son in-law | The player of the role is the husband of scoping person's daughter. | ||||
http://terminology.hl7.org/CodeSystem/v3-RoleCode | GRNDCHILD | grandchild | The player of the role is a child of the scoping person's son or daughter. | ||||
http://terminology.hl7.org/CodeSystem/v3-RoleCode | GRNDDAU | granddaughter | The player of the role is a daughter of the scoping person's son or daughter. | ||||
http://terminology.hl7.org/CodeSystem/v3-RoleCode | GRNDSON | grandson | The player of the role is a son of the scoping person's son or daughter. | ||||
http://terminology.hl7.org/CodeSystem/v3-RoleCode | PRN | parent | The player of the role is one who begets, gives birth to, or nurtures and raises the scoping entity (child). | ||||
http://terminology.hl7.org/CodeSystem/v3-RoleCode | ADOPTP | adoptive parent | The player of the role (parent) has taken the scoper (child) into their family through legal means and raises them as his or her own child. | ||||
http://terminology.hl7.org/CodeSystem/v3-RoleCode | ADOPTF | adoptive father | The player of the role (father) is a male who has taken the scoper (child) into their family through legal means and raises them as his own child. | ||||
http://terminology.hl7.org/CodeSystem/v3-RoleCode | ADOPTM | adoptive mother | The player of the role (father) is a female who has taken the scoper (child) into their family through legal means and raises them as her own child. | ||||
http://terminology.hl7.org/CodeSystem/v3-RoleCode | FTH | father | The player of the role is a male who begets or raises or nurtures the scoping entity (child). | ||||
http://terminology.hl7.org/CodeSystem/v3-RoleCode | FTHFOST | foster father | The player of the role (parent) who is a male state-certified caregiver responsible for the scoper (child) who has been placed in the parent's care. The placement of the child is usually arranged through the government or a social-service agency, and temporary. The state, via a jurisdiction recognized child protection agency, stands as in loco parentis to the child, making all legal decisions while the foster parent is responsible for the day-to-day care of the specified child. | ||||
http://terminology.hl7.org/CodeSystem/v3-RoleCode | NFTH | natural father | The player of the role is a male who begets the scoping entity (child). | ||||
http://terminology.hl7.org/CodeSystem/v3-RoleCode | NFTHF | natural father of fetus | Indicates the biologic male parent of a fetus. | ||||
http://terminology.hl7.org/CodeSystem/v3-RoleCode | STPFTH | stepfather | The player of the role is the husband of scoping person's mother and not the scoping person's natural father. | ||||
http://terminology.hl7.org/CodeSystem/v3-RoleCode | MTH | mother | The player of the role is a female who conceives, gives birth to, or raises and nurtures the scoping entity (child). | ||||
http://terminology.hl7.org/CodeSystem/v3-RoleCode | GESTM | gestational mother | The player is a female whose womb carries the fetus of the scoper. Generally used when the gestational mother and natural mother are not the same. | ||||
http://terminology.hl7.org/CodeSystem/v3-RoleCode | MTHFOST | foster mother | The player of the role (parent) who is a female state-certified caregiver responsible for the scoper (child) who has been placed in the parent's care. The placement of the child is usually arranged through the government or a social-service agency, and temporary. The state, via a jurisdiction recognized child protection agency, stands as in loco parentis to the child, making all legal decisions while the foster parent is responsible for the day-to-day care of the specified child. | ||||
http://terminology.hl7.org/CodeSystem/v3-RoleCode | NMTH | natural mother | The player of the role is a female who conceives or gives birth to the scoping entity (child). | ||||
http://terminology.hl7.org/CodeSystem/v3-RoleCode | NMTHF | natural mother of fetus | The player is the biologic female parent of the scoping fetus. | ||||
http://terminology.hl7.org/CodeSystem/v3-RoleCode | STPMTH | stepmother | The player of the role is the wife of scoping person's father and not the scoping person's natural mother. | ||||
http://terminology.hl7.org/CodeSystem/v3-RoleCode | NPRN | natural parent | |||||
http://terminology.hl7.org/CodeSystem/v3-RoleCode | PRNFOST | foster parent | The player of the role (parent) who is a state-certified caregiver responsible for the scoper (child) who has been placed in the parent's care. The placement of the child is usually arranged through the government or a social-service agency, and temporary. The state, via a jurisdiction recognized child protection agency, stands as in loco parentis to the child, making all legal decisions while the foster parent is responsible for the day-to-day care of the specified child. | ||||
http://terminology.hl7.org/CodeSystem/v3-RoleCode | STPPRN | step parent | The player of the role is the spouse of the scoping person's parent and not the scoping person's natural parent. | ||||
http://terminology.hl7.org/CodeSystem/v3-RoleCode | PRNINLAW | parent in-law | The player of the role is the parent of scoping person's husband or wife. | ||||
http://terminology.hl7.org/CodeSystem/v3-RoleCode | FTHINLAW | father-in-law | The player of the role is the father of the scoping person's husband or wife. | ||||
http://terminology.hl7.org/CodeSystem/v3-RoleCode | MTHINLAW | mother-in-law | The player of the role is the mother of the scoping person's husband or wife. | ||||
http://terminology.hl7.org/CodeSystem/v3-RoleCode | MTHINLOAW | mother-in-law | inactive | The player of the role is the mother of the scoping person's husband or wife. | retired | ||
http://terminology.hl7.org/CodeSystem/v3-RoleCode | SIB | sibling | The player of the role shares one or both parents in common with the scoping entity. | ||||
http://terminology.hl7.org/CodeSystem/v3-RoleCode | BRO | brother | The player of the role is a male sharing one or both parents in common with the scoping entity. | ||||
http://terminology.hl7.org/CodeSystem/v3-RoleCode | HBRO | half-brother | The player of the role is a male related to the scoping entity by sharing only one biological parent. | ||||
http://terminology.hl7.org/CodeSystem/v3-RoleCode | NBRO | natural brother | The player of the role is a male having the same biological parents as the scoping entity. | ||||
http://terminology.hl7.org/CodeSystem/v3-RoleCode | TWINBRO | twin brother | The scoper was carried in the same womb as the male player and shares common biological parents. | ||||
http://terminology.hl7.org/CodeSystem/v3-RoleCode | FTWINBRO | fraternal twin brother | The scoper was carried in the same womb as the male player and shares common biological parents but is the product of a distinct egg/sperm pair. | ||||
http://terminology.hl7.org/CodeSystem/v3-RoleCode | ITWINBRO | identical twin brother | The male scoper is an offspring of the same egg-sperm pair as the male player. | ||||
http://terminology.hl7.org/CodeSystem/v3-RoleCode | STPBRO | stepbrother | The player of the role is a son of the scoping person's stepparent. | ||||
http://terminology.hl7.org/CodeSystem/v3-RoleCode | HSIB | half-sibling | The player of the role is related to the scoping entity by sharing only one biological parent. | ||||
http://terminology.hl7.org/CodeSystem/v3-RoleCode | HSIS | half-sister | The player of the role is a female related to the scoping entity by sharing only one biological parent. | ||||
http://terminology.hl7.org/CodeSystem/v3-RoleCode | NSIB | natural sibling | The player of the role has both biological parents in common with the scoping entity. | ||||
http://terminology.hl7.org/CodeSystem/v3-RoleCode | NSIS | natural sister | The player of the role is a female having the same biological parents as the scoping entity. | ||||
http://terminology.hl7.org/CodeSystem/v3-RoleCode | TWINSIS | twin sister | The scoper was carried in the same womb as the female player and shares common biological parents. | ||||
http://terminology.hl7.org/CodeSystem/v3-RoleCode | FTWINSIS | fraternal twin sister | The scoper was carried in the same womb as the female player and shares common biological parents but is the product of a distinct egg/sperm pair. | ||||
http://terminology.hl7.org/CodeSystem/v3-RoleCode | ITWINSIS | identical twin sister | The female scoper is an offspring of the same egg-sperm pair as the female player. | ||||
http://terminology.hl7.org/CodeSystem/v3-RoleCode | TWIN | twin | The scoper and player were carried in the same womb and shared common biological parents. | ||||
http://terminology.hl7.org/CodeSystem/v3-RoleCode | FTWIN | fraternal twin | The scoper and player were carried in the same womb and share common biological parents but are the product of distinct egg/sperm pairs. | ||||
http://terminology.hl7.org/CodeSystem/v3-RoleCode | ITWIN | identical twin | The scoper and player are offspring of the same egg-sperm pair. | ||||
http://terminology.hl7.org/CodeSystem/v3-RoleCode | SIS | sister | The player of the role is a female sharing one or both parents in common with the scoping entity. | ||||
http://terminology.hl7.org/CodeSystem/v3-RoleCode | STPSIS | stepsister | The player of the role is a daughter of the scoping person's stepparent. | ||||
http://terminology.hl7.org/CodeSystem/v3-RoleCode | STPSIB | step sibling | The player of the role is a child of the scoping person's stepparent. | ||||
http://terminology.hl7.org/CodeSystem/v3-RoleCode | FAMMEMB | family member | A relationship between two people characterizing their "familial" relationship | ||||
http://terminology.hl7.org/CodeSystem/v3-NullFlavor | UNK | unknown | **Description:**A proper value is applicable, but not known. Usage Notes: This means the actual value is not known. If the only thing that is unknown is how to properly express the value in the necessary constraints (value set, datatype, etc.), then the OTH or UNC flavor should be used. No properties should be included for a datatype with this property unless:
|
Explanation of the columns that may appear on this page:
| Level | A few code lists that FHIR defines are hierarchical - each code is assigned a level. In this scheme, some codes are under other codes, and imply that the code they are under also applies |
| System | The source of the definition of the code (when the value set draws in codes defined elsewhere) |
| Code | The code (used as the code in the resource instance) |
| Display | The display (used in the display element of a Coding). If there is no display, implementers should not simply display the code, but map the concept into their application |
| Definition | An explanation of the meaning of the concept |
| Comments | Additional notes about how to use the code |