> For the complete documentation index, see [llms.txt](https://standards.spdci.org/standards/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://standards.spdci.org/standards/dci-standards/wip-integrated-beneficiary-registry-v1.0.0/ibr/1.-crvs/data/data-objects/do.ibr.04-beneficiary.md).

# 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="/standards/standards-for-interoperability-interfaces/common-standards-for-interoperability-interfaces/data/code-directory/cd.com.13-assistance_unit.md">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="/standards/dci-standards/wip-integrated-beneficiary-registry-v1.0.0/ibr/1.-crvs/data/data-objects/do.ibr.03-group.md">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="/standards/dci-standards/wip-integrated-beneficiary-registry-v1.0.0/ibr/1.-crvs/data/data-objects/do.ibr.02-member.md">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="/standards/dci-standards/wip-integrated-beneficiary-registry-v1.0.0/ibr/1.-crvs/data/data-objects/do.ibr.02-programme.md">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="/standards/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.md">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="/standards/dci-standards/wip-integrated-beneficiary-registry-v1.0.0/ibr/1.-crvs/data/code-directory/cd.ibr.01-enrolment_status.md">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="/standards/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.md">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="/standards/dci-standards/wip-integrated-beneficiary-registry-v1.0.0/ibr/1.-crvs/data/data-objects/do.ibr.03-benefit.md">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="/standards/standards-for-interoperability-interfaces/common-standards-for-interoperability-interfaces/data/data-types-and-formats/dt.com.05-array.md">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>" %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://standards.spdci.org/standards/dci-standards/wip-integrated-beneficiary-registry-v1.0.0/ibr/1.-crvs/data/data-objects/do.ibr.04-beneficiary.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.