# DO.SR.03 Group

### DO.SR.03 Group

A group is a collection of related individuals in the social registry. This data entity is used to cluster associated members and define shared attributes such as poverty scores and registration dates.

<table><thead><tr><th width="175.8385009765625">Attribute</th><th width="167.5250244140625" data-type="content-ref">Type</th><th width="115.65234375">Cardinality</th><th>Description</th></tr></thead><tbody><tr><td>group_identifier</td><td><a href="https://app.gitbook.com/s/F9fu0tIY1rJUsF03WdAv/standards-for-interoperability-interfaces/common-standards-for-interoperability-interfaces/data/data-objects/do.com.01-identifier">DO.COM.01 Identifier</a></td><td>0...*</td><td>Identifier for a group that individual members are linked to</td></tr><tr><td>group_type</td><td><a 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>Type of grouping of individuals in a registry</td></tr><tr><td>place</td><td><a href="https://app.gitbook.com/s/F9fu0tIY1rJUsF03WdAv/standards-for-interoperability-interfaces/common-standards-for-interoperability-interfaces/data/data-objects/do.com.07-place">DO.COM.07 Place</a></td><td>0...1</td><td>Geographical location of the group</td></tr><tr><td>address</td><td><a href="https://app.gitbook.com/s/F9fu0tIY1rJUsF03WdAv/standards-for-interoperability-interfaces/common-standards-for-interoperability-interfaces/data/data-objects/do.com.03-address">DO.COM.03 Address</a></td><td>0...1</td><td>Address of the group</td></tr><tr><td>place_address</td><td><a href="https://app.gitbook.com/s/F9fu0tIY1rJUsF03WdAv/standards-for-interoperability-interfaces/common-standards-for-interoperability-interfaces/data/data-types-and-formats/dt.com.06-boolean">DT.COM.06 boolean</a></td><td>0...1</td><td>1 for place and 0 for address to decide what attributes need to be filled place or address</td></tr><tr><td>poverty_score</td><td><a href="https://app.gitbook.com/s/F9fu0tIY1rJUsF03WdAv/standards-for-interoperability-interfaces/common-standards-for-interoperability-interfaces/data/data-types-and-formats/dt.com.04-decimal">DT.COM.04 decimal</a></td><td>0...1</td><td>A metric generated based on the assessment of various household characteristics</td></tr><tr><td>poverty_score_type</td><td><a 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">DT.COM.02 string</a></td><td>0...1</td><td>Types of poverty scores that are to be measured and that categorise the level of poverty</td></tr><tr><td>group_head_info</td><td><a href="do.sr.02-member">do.sr.02-member</a></td><td>0...1</td><td>Personal details of the head of the group</td></tr><tr><td>group_size</td><td><a href="https://app.gitbook.com/s/F9fu0tIY1rJUsF03WdAv/standards-for-interoperability-interfaces/common-standards-for-interoperability-interfaces/data/data-types-and-formats/dt.com.03-integer">DT.COM.03 integer</a></td><td>0...1</td><td>Total number of members in the group</td></tr><tr><td>member_list</td><td><a href="do.sr.02-member">do.sr.02-member</a></td><td>0...*</td><td>List of the related individuals in a group</td></tr><tr><td>registration_date</td><td><a 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 details of the group were registered</td></tr><tr><td>last_updated</td><td><a 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 details of the group were last updated</td></tr><tr><td>additional_attributes</td><td><a 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 group</td></tr></tbody></table>

### Example of JSON Data for a Group Data Object

The provided JSON snippet outlines a group's record, including details about the group head and members.&#x20;

```json
{
  "@context": {
    "spdci": "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/"
  },
  "@id": "https://example.org/group/001",
  "@type": "spdci:Group",
  "group_identifier": [ {
        "@type": "Identifier",
        "identifier_type": "NationalID",
        "identifier_value": "G9876543210"
      }],
  "group_type": "family",
  "place": {
    "@type": "Place",
    "geo": {
      "@type": "GeoCoordinates",
      "latitude": "40.712776",
      "longitude": "-74.005974"
    },
    "address": "123 Main St, Anytown, CountryName"
  },
  "place_address": 1,
  "poverty_score": 45.2,
  "poverty_score_type": "income-based",
  "group_head_info": {
    "@type": "spdci:Member",
    "@id": "https://example.org/member/987654321",
    "member_identifier":  [ {
        "@type": "Identifier",
        "identifier_type": "NationalID",
        "identifier_value": "M9876543210"
      }],
    "demographic_info": {
      "@type": "SRPerson",
      "identifier": [ {
        "@type": "Identifier",
        "identifier_type": "NationalID",
        "identifier_value": "9876543210"
      }],
      "name": {
        "@type": "Name",
        "surname": "Smith",
        "given_name": "Alice",
        "prefix": "Ms.",
        "suffix": ""
      },
      "sex": "female",
      "address": {
        "@type": "Address",
        "street_address": "123 Main St",
        "city": "Anytown",
        "postal_code": "12345",
        "country": "CountryName"
      },
      "birth_date": "1985-05-20T00:00:00Z",
      "registration_date": "2022-01-10T08:00:00Z",
    },
    "is_disabled": false,
    "marital_status": "married",
    "registration_date": "2022-01-10T08:00:00Z"
  },
  "group_size": 4,
  "member_list": [
    {
      "@type": "Member",
      "@id": "https://example.org/member/987654321",
      "member_identifier": [ {
          "@type": "Identifier",
          "identifier_type": "NationalID",
          "identifier_value": "M9876543210"
        }],
      "demographic_info": {
        "@type": "SRPerson",
        "identifier":[ {
          "@type": "Identifier",
          "identifier_type": "NationalID",
          "identifier_value": "9876543210"
        }],
        "name": {
          "@type": "Name",
          "surname": "Smith",
          "given_name": "Alice",
          "prefix": "Ms.",
          "suffix": ""
        } ,
        "sex": "female",
        "address": {
          "@type": "Address",
          "street_address": "123 Main St",
          "city": "Anytown",
          "postal_code": "12345",
          "country": "CountryName"
        },
        "birth_date": "1985-05-20T00:00:00Z",
        "registration_date": "2022-01-10T08:00:00Z",
      },
      "is_disabled": false,
      "marital_status": "married",
      "registration_date": "2022-01-10T08:00:00Z"
    },
    {
      "@type": "Member",
      "@id": "https://example.org/member/123456789",
      "spdci:member_identifier": [ {
          "@type": "Identifier",
          "identifier_type": "NationalID",
          "identifier_value": "M9876543210"
        }],
      "demographic_info": {
        "@type": "SRPerson",
        "spdci:identifier": [ {
          "@type": "Identifier",
          "identifier_type": "NationalID",
          "identifier_value": "1234567890"
        }],
        "name": {
          "@type": "Name",
          "surname": "Smith",
          "given_name": "Bob",
          "prefix": "Mr.",
          "suffix": ""
        },
        "sex": "male",
        "address": {
          "@type": "Address",
          "street_address": "123 Main St",
          "city": "Anytown",
          "postal_code": "12345",
          "country": "CountryName"
        },
        "birth_date": "1982-03-15T00:00:00Z",
        "registration_date": "2022-01-10T08:00:00Z",
      },
      "is_disabled": false,
      "marital_status": "married",
      "registration_date": "2022-01-10T08:00:00Z"
    },
    {
      "@type": "Member",
      "@id": "https://example.org/member/987654322",
      "member_identifier": [ {
          "@type": "Identifier",
          "identifier_type": "NationalID",
          "identifier_value": "9876543210"
        }],
      "demographic_info": {
        "@type": "SRPerson",
        ":identifier": [{
          "@type": "Identifier",
          "identifier_type": "NationalID",
          "identifier_value": "9876543221"
        }],
        "name": {
          "@type": "cName",
          "surname": "Smith",
          "given_name": "Charlie",
          "prefix": "",
          "suffix": ""
        },
        "sex": "male",
        "address": {
        "@type": "Address",
          "street_address": "123 Main St",
          "city": "Anytown",
          "postal_code": "12345",
          "country": "CountryName"
        },
        "birth_date": "2010-07-05T00:00:00Z",     
        "registration_date": "2022-01-10T08:00:00Z"
      },
      "is_disabled": false,
      "marital_status": "single",
      "registration_date": "2022-01-10T08:00:00Z"
    },
    {
      "@type": "Member",
      "@id": "https://example.org/member/987654323",
      "member_identifier": "M987654323",
      "demographic_info": {
        "@type": "SRPerson",
        "identifier": [{
          "@type": "Identifier",
          "identifier_type": "NationalID",
          "identifier_value": "9876543232"
        }],
        "name": {
          "@type": "Name",
          "surname": "Smith",
          "given_name": "Daisy",
          "prefix": "",
          "suffix": ""
        },
        "sex": "female",
        "address": {
          "@type": "Address",
          "street_address": "123 Main St",
          "city": "Anytown",
          "postal_code": "12345",
          "country": "CountryName"
        },
        "birth_date": "2012-09-22T00:00:00Z",
        "sregistration_date": "2022-01-10T08:00:00Z"
      },
      "is_disabled": false,
      "marital_status": "single",
      "spdci:registration_date": "2022-01-10T08:00:00Z"
    }
  ],
  "registration_date": "2022-01-10T08:00:00Z",
  "last_updated": "2023-06-15T10:00:00Z",
  "additional_attributes": ["services":"receives_subsidy"]
}

```

### JSON-LD File on GitHub

{% @github-files/github-code-block url="<https://github.com/spdci/schemas/blob/main/extensions/social/v1/Group.jsonld>" %}