# 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: 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:

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

The question should be specific, self-contained, and written in natural language.
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.