> 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="/spaces/F9fu0tIY1rJUsF03WdAv/pages/8jDkJk3wvUbxqMeakIh1">/spaces/F9fu0tIY1rJUsF03WdAv/pages/8jDkJk3wvUbxqMeakIh1</a></td><td>0...1</td><td>Entity benefiting from the programme</td></tr><tr><td>group</td><td><a data-mention href="/pages/tF00lQaYAa1YPQMd02Jh">/pages/tF00lQaYAa1YPQMd02Jh</a></td><td>0...1</td><td>Household assistance unit</td></tr><tr><td>member</td><td><a data-mention href="/pages/e28Vj5L3YD1ldWCNfqxa">/pages/e28Vj5L3YD1ldWCNfqxa</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="/pages/5rLz04GmIMgkHvFiB9ma">/pages/5rLz04GmIMgkHvFiB9ma</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="/spaces/F9fu0tIY1rJUsF03WdAv/pages/HzeJPTMw9koOgH2lEKt8">/spaces/F9fu0tIY1rJUsF03WdAv/pages/HzeJPTMw9koOgH2lEKt8</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="/pages/h7rD7MGjvOFD5CtnOx9j">/pages/h7rD7MGjvOFD5CtnOx9j</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="/spaces/F9fu0tIY1rJUsF03WdAv/pages/HzeJPTMw9koOgH2lEKt8">/spaces/F9fu0tIY1rJUsF03WdAv/pages/HzeJPTMw9koOgH2lEKt8</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="/pages/2qIXUEO1LyU7OgIMKTD7">/pages/2qIXUEO1LyU7OgIMKTD7</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="/spaces/F9fu0tIY1rJUsF03WdAv/pages/9N8tb1uyZsNZ0hqrofMZ">/spaces/F9fu0tIY1rJUsF03WdAv/pages/9N8tb1uyZsNZ0hqrofMZ</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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
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=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.