# DO.IBR.04 Beneficiary

### DO.IBR.04 Beneficiary

This data object contains information conveyed from the SP-MIS to the IBR regarding beneficiaries, who could be individuals, families or households, and the benefits received. For families and households, information about the head or nominated beneficiary is provided. The data object also includes details on the most recently provided benefit and current enrolment status in the programme. Some personal data available in the SP-MIS, but not required in the IBR, is excluded for data protection purposes.

<table><thead><tr><th width="166">Attribute</th><th width="188">Type</th><th width="118">Cardinality</th><th>Description</th></tr></thead><tbody><tr><td>assistance_unit</td><td><a data-mention href="https://app.gitbook.com/s/F9fu0tIY1rJUsF03WdAv/standards-for-interoperability-interfaces/common-standards-for-interoperability-interfaces/data/code-directory/cd.com.13-assistance_unit">CD.COM.13: assistance_unit</a></td><td>0...1</td><td>Entity benefiting from the programme</td></tr><tr><td>group</td><td><a data-mention href="do.ibr.03-group">do.ibr.03-group</a></td><td>0...1</td><td>Household assistance unit</td></tr><tr><td>member</td><td><a data-mention href="do.ibr.02-member">do.ibr.02-member</a></td><td>0...1</td><td>An individual belonging to a family or household</td></tr><tr><td>programme_identifier</td><td><a data-mention href="do.ibr.02-programme">do.ibr.02-programme</a></td><td>0...*</td><td>Programme in which the beneficiary is/was enrolled and accompanying information</td></tr><tr><td>enrolment_date</td><td><a data-mention href="https://app.gitbook.com/s/F9fu0tIY1rJUsF03WdAv/standards-for-interoperability-interfaces/common-standards-for-interoperability-interfaces/data/data-types-and-formats/dt.com.02-string/data-formats/df.com.string.01-date_time">DF.COM.STRING.01 date_time</a></td><td>0...1</td><td>Date the beneficiary was enrolled in the programme</td></tr><tr><td>enrolment_status</td><td><a data-mention href="../code-directory/cd.ibr.01-enrolment_status">cd.ibr.01-enrolment_status</a></td><td>0...1</td><td>Beneficiary's status with a specific programme</td></tr><tr><td>status_change_date</td><td><a data-mention href="https://app.gitbook.com/s/F9fu0tIY1rJUsF03WdAv/standards-for-interoperability-interfaces/common-standards-for-interoperability-interfaces/data/data-types-and-formats/dt.com.02-string/data-formats/df.com.string.01-date_time">DF.COM.STRING.01 date_time</a></td><td>0...*</td><td>Date the beneficiary's enrolment status changed in the programme</td></tr><tr><td>benefits</td><td><a data-mention href="do.ibr.03-benefit">do.ibr.03-benefit</a></td><td>0...*</td><td>List of benefits received by the beneficiary</td></tr><tr><td>additional_attributes</td><td><a data-mention href="https://app.gitbook.com/s/F9fu0tIY1rJUsF03WdAv/standards-for-interoperability-interfaces/common-standards-for-interoperability-interfaces/data/data-types-and-formats/dt.com.05-array">DT.COM.05 array</a></td><td>0...*</td><td>Additional attributes of the beneficiary</td></tr></tbody></table>

### Example of JSON Data Structure for a Family Assistance Unit Beneficiary

```json
{
  "@context": {
    "spdci": "https://schema.spdci.org/extensions/ibr/v1/",
    "social": "https://schema.spdci.org/extensions/social/v1/",
    "rdfs": "http://www.w3.org/2000/01/rdf-schema#",
    "xsd": "http://www.w3.org/2001/XMLSchema#",
    "owl": "http://www.w3.org/2002/07/owl#",
    "common": "https://schema.spdci.org/common/v1/"
  },
  "@type": "spdci:Beneficiary",
  "assistance_unit": "family",
  "group": {
    "@type": "Group",
    "group_identifier": [
    {
      "@type": "Identifier",
      "identifier_type": "UIN",
      "identifier_value": "847951632"
    }
  ],
    "group_type": "family",
    "place_address":0,
    "address": {
      "@type": "Address",
      "street_address": "123 Main St",
      "city": "Anytown",
      "postal_code": "12345",
      "country": "CountryName"
    }
  },
  "programme_identifier": [
    {
      "programme_name": "Health Support Program",
      "programme_code": "HSP001"
    },
    {
      "programme_name": "Education Aid",
      "programme_code": "EDU001"
    }
  ],
  "enrollment_date": "2023-01-01T08:00:00Z",
  "enrollment_status": "active",
  "status_change_date": ["2023-01-01T08:00:00Z"],
  "benefits": [
    {
      "@type": "Benefit",
      "benefit_name": "Healthcare Coverage",
      "benefit_amount": "1000",
      "currency": "USD",
      "date_received": "2023-01-01T08:00:00Z"
    },
    {
      "@type": "Benefit",
      "benefit_name": "Educational Grant",
      "benefit_amount": "500",
      "currency": "USD",
      "date_received": "2023-01-01T08:00:00Z"
    }
  ]
}

```

### Example of JSON Data Structure for a Person/Group Member Assistance Unit Beneficiary

```json
{
  "@context": {
    "spdci": "https://schema.spdci.org/extensions/ibr/v1/",
    "social": "https://schema.spdci.org/extensions/social/v1/",
    "rdfs": "http://www.w3.org/2000/01/rdf-schema#",
    "xsd": "http://www.w3.org/2001/XMLSchema#",
    "owl": "http://www.w3.org/2002/07/owl#",
    "common": "https://schema.spdci.org/common/v1/"
  },
  "@type": "spdci:Beneficiary",
  "assistance_unit": "member",
  "member": {
    "@type": "Member",
    "member_identifier": [{
        "identifier_type": "NationalID",
        "identifier_value": "1234567890"
      }],
    "demographic_info": {
      "@type": "Person",
      "identifier":[ {
        "@type": "Identifier",
        "identifier_type": "NationalID",
        "identifier_value": "1234567890"
      }],
      "name": {
        "@type": "Name",
        "surname": "Doe",
        "given_name": "John",
        "prefix": "Mr.",
        "suffix": ""
      },
      "sex": "male",
      "birth_date": "1980-01-01"
    }
  },
  "programme_identifier": [
    {
      "programme_name": "Health Support Program",
      "programme_code": "HSP001"
    },
    {
      "programme_name": "Education Aid",
      "programme_code": "EDU001"
    }
  ],
  "enrollment_date": "2023-01-01T08:00:00Z",
  "enrollment_status": "active",
  "status_change_date": ["2023-01-01T08:00:00Z"],
  "benefits": [
    {
      "benefit_name": "Healthcare Coverage",
      "benefit_amount": "1000",
      "currency": "USD",
      "date_received": "2023-01-15"
    },
    {
      "benefit_name": "Educational Grant",
      "benefit_amount": "500",
      "currency": "USD",
      "date_received": "2023-02-01"
    }
  ]
}

```

### JSON-LD file on GitHub

{% embed url="<https://schema.spdci.org/extensions/ibr/v1/data/Beneficiary.jsonld>" %}