# Plan Beneficiaries - CARIN Digital Insurance Card v2.0.0-ballot

* [**Table of Contents**](toc.md)
* [**Artifacts Summary**](artifacts.md)
* **Plan Beneficiaries**

## Extension: Plan Beneficiaries 

| | | |
| :--- | :--- | :--- |
| *Official URL*:http://hl7.org/fhir/us/insurance-card/StructureDefinition/C4DIC-PlanBeneficiaries-extension | *Version*:2.0.0-ballot | |
| * Standards status: *[Trial-use](http://hl7.org/fhir/R4/versions.html#std-process) | [Maturity Level](http://hl7.org/fhir/versions.html#maturity): 2 | *Computable Name*:PlanBeneficiaries |
| *Other Identifiers:*OID:2.16.840.1.113883.4.642.40.9.42.13 | | |

This extension allows for the representation of all of the members on the plan with corresponding Names and MemberIDs. This enables health plans to pass this information along with the Coverage resources to align with how this content is printed on physical insurance cards.

**Context of Use**

This extension may be used on the following element(s):

* Element ID Coverage

**Usage info**

**Usages:**

* Use this Extension: [C4DIC Coverage](StructureDefinition-C4DIC-Coverage.md)
* Examples for this Extension: [Coverage/Example-Coverage-FSH](Coverage-Example-Coverage-FSH.md) and [Coverage/Example-Coverage1](Coverage-Example-Coverage1.md)

You can also check for [usages in the FHIR IG Statistics](https://packages2.fhir.org/xig/resource/hl7.fhir.us.insurance-card|current/StructureDefinition/StructureDefinition-C4DIC-PlanBeneficiaries-extension.json)

### Formal Views of Extension Content

 [Description of Profiles, Differentials, Snapshots, and how the XML and JSON presentations work](http://build.fhir.org/ig/FHIR/ig-guidance/readingIgs.html#structure-definitions). 

 

Other representations of profile: [CSV](StructureDefinition-C4DIC-PlanBeneficiaries-extension.csv), [Excel](StructureDefinition-C4DIC-PlanBeneficiaries-extension.xlsx), [Schematron](StructureDefinition-C4DIC-PlanBeneficiaries-extension.sch) 

#### Terminology Bindings

#### Constraints



## Resource Content

```json
{
  "resourceType" : "StructureDefinition",
  "id" : "C4DIC-PlanBeneficiaries-extension",
  "extension" : [{
    "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-wg",
    "valueCode" : "claims"
  },
  {
    "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm",
    "valueInteger" : 2,
    "_valueInteger" : {
      "extension" : [{
        "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-conformance-derivedFrom",
        "valueCanonical" : "http://hl7.org/fhir/us/insurance-card/ImplementationGuide/hl7.fhir.us.insurance-card"
      }]
    }
  },
  {
    "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status",
    "valueCode" : "trial-use",
    "_valueCode" : {
      "extension" : [{
        "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-conformance-derivedFrom",
        "valueCanonical" : "http://hl7.org/fhir/us/insurance-card/ImplementationGuide/hl7.fhir.us.insurance-card"
      }]
    }
  }],
  "url" : "http://hl7.org/fhir/us/insurance-card/StructureDefinition/C4DIC-PlanBeneficiaries-extension",
  "identifier" : [{
    "system" : "urn:ietf:rfc:3986",
    "value" : "urn:oid:2.16.840.1.113883.4.642.40.9.42.13"
  }],
  "version" : "2.0.0-ballot",
  "name" : "PlanBeneficiaries",
  "title" : "Plan Beneficiaries",
  "status" : "active",
  "date" : "2026-08-13T02:29:19+10:00",
  "publisher" : "HL7 International / Payer/Provider Information Exchange Work Group",
  "contact" : [{
    "name" : "HL7 International / Payer/Provider Information Exchange Work Group",
    "telecom" : [{
      "system" : "url",
      "value" : "http://www.hl7.org/Special/committees/claims"
    },
    {
      "system" : "email",
      "value" : "pie@lists.HL7.org"
    }]
  }],
  "description" : "This extension allows for the representation of all of the members on the plan with corresponding Names and MemberIDs. This enables health plans to pass this information along with the Coverage resources to align with how this content is printed on physical insurance cards.",
  "jurisdiction" : [{
    "coding" : [{
      "system" : "urn:iso:std:iso:3166",
      "code" : "US"
    }]
  }],
  "fhirVersion" : "4.0.1",
  "mapping" : [{
    "identity" : "rim",
    "uri" : "http://hl7.org/v3",
    "name" : "RIM Mapping"
  }],
  "kind" : "complex-type",
  "abstract" : false,
  "context" : [{
    "type" : "element",
    "expression" : "Coverage"
  }],
  "type" : "Extension",
  "baseDefinition" : "http://hl7.org/fhir/StructureDefinition/Extension",
  "derivation" : "constraint",
  "differential" : {
    "element" : [{
      "id" : "Extension",
      "path" : "Extension",
      "short" : "Plan Beneficiaries",
      "definition" : "This extension allows for the representation of all of the members on the plan with corresponding Names and MemberIDs. This enables health plans to pass this information along with the Coverage resources to align with how this content is printed on physical insurance cards."
    },
    {
      "id" : "Extension.extension",
      "path" : "Extension.extension",
      "min" : 2
    },
    {
      "id" : "Extension.extension:memberId",
      "path" : "Extension.extension",
      "sliceName" : "memberId",
      "short" : "Member Id as string",
      "min" : 1,
      "max" : "1",
      "mustSupport" : true
    },
    {
      "id" : "Extension.extension:memberId.extension",
      "path" : "Extension.extension.extension",
      "max" : "0"
    },
    {
      "id" : "Extension.extension:memberId.url",
      "path" : "Extension.extension.url",
      "fixedUri" : "memberId"
    },
    {
      "id" : "Extension.extension:memberId.value[x]",
      "path" : "Extension.extension.value[x]",
      "min" : 1,
      "type" : [{
        "code" : "id"
      },
      {
        "code" : "string"
      }]
    },
    {
      "id" : "Extension.extension:name",
      "path" : "Extension.extension",
      "sliceName" : "name",
      "short" : "Member Name",
      "min" : 1,
      "max" : "1",
      "mustSupport" : true
    },
    {
      "id" : "Extension.extension:name.extension",
      "path" : "Extension.extension.extension",
      "max" : "0"
    },
    {
      "id" : "Extension.extension:name.url",
      "path" : "Extension.extension.url",
      "fixedUri" : "name"
    },
    {
      "id" : "Extension.extension:name.value[x]",
      "path" : "Extension.extension.value[x]",
      "min" : 1,
      "type" : [{
        "code" : "HumanName"
      }]
    },
    {
      "id" : "Extension.extension:name.value[x].family",
      "path" : "Extension.extension.value[x].family",
      "min" : 1,
      "mustSupport" : true
    },
    {
      "id" : "Extension.extension:name.value[x].given",
      "path" : "Extension.extension.value[x].given",
      "mustSupport" : true
    },
    {
      "id" : "Extension.extension:personReference",
      "path" : "Extension.extension",
      "sliceName" : "personReference",
      "short" : "Reference to the Person resource",
      "min" : 0,
      "max" : "1"
    },
    {
      "id" : "Extension.extension:personReference.extension",
      "path" : "Extension.extension.extension",
      "max" : "0"
    },
    {
      "id" : "Extension.extension:personReference.url",
      "path" : "Extension.extension.url",
      "fixedUri" : "personReference"
    },
    {
      "id" : "Extension.extension:personReference.value[x]",
      "path" : "Extension.extension.value[x]",
      "min" : 1,
      "type" : [{
        "code" : "Reference",
        "targetProfile" : ["http://hl7.org/fhir/StructureDefinition/Person"]
      }]
    },
    {
      "id" : "Extension.url",
      "path" : "Extension.url",
      "fixedUri" : "http://hl7.org/fhir/us/insurance-card/StructureDefinition/C4DIC-PlanBeneficiaries-extension"
    },
    {
      "id" : "Extension.value[x]",
      "path" : "Extension.value[x]",
      "max" : "0"
    }]
  }
}

```
