Linked Art API: Group

Introduction

The Group API is a method of getting access to descriptions of sets of people and/or subgroups, such as families, organizations, companies, departments or any other identifiable set of actors. The Group model is of average complexity with many familiar properties and patterns, plus a few more specific fields. This results in an average complexity API, which is very similar to the Person API, that can result in reasonably long JSON responses if all of the fields have values.

For more information about the usage of Group data, please see the Group model description.

Property Definitions

Dereferencing an entity via the Group endpoint would result in a JSON-LD document containing a single JSON object with the following properties.

Properties of Groups

Property Name Datatype Requirement Description
@context string, array Required The value MUST be the URI of the Linked Art context as a string, "https://linked.art/ns/v1/linked-art.json" or an array in which the URI is the last entry to allow for extensions
id string Required The value MUST be the HTTP(S) URI at which the group's representation can be dereferenced
type string Required The class for the group, which MUST be the value "Group"
_label string Recommended A human readable label for the group, intended for developers
classified_as array Recommended An array of json objects, each of which is a classification of the group and MUST follow the requirements for Type
identified_by array Recommended An array of json objects, each of which is a name of the group and MUST follow the requirements for Name, or an identifier for the group and MUST follow the requirements for Identifier
referred_to_by array Optional An array of json objects, each of which is a human readable statement about the group and MUST follow the requirements for Statement
equivalent array Optional An array of json objects, each of which is a reference to an external identity and description of the current group
representation array Optional An array of json objects, each of which is a reference to a Visual Work that represents the current group, and MUST follow the requirements for a reference
member_of array Optional An array of json objects, each of which is a Group that the current group is a member of and MUST follow the requirements for a reference to a Group
subject_of array Optional An array of json objects, each of which is a reference to a Textual Work, the content of which focuses on the current group, and MUST follow the requirements for a reference
attributed_by array Optional An array of json objects, each of which is a Relationship Assignment that relates the current group to another entity
carried_out array Optional An array of json objects, each of which represents professional activities of the group and follows the requirements for Professional Activities described below.
contact_point array Optional An array of json objects, each of which is an address at which the group is reachable and MUST follow the requirements for an Identifier
residence array Optional A place that the group was associated with, and MUST follow the requirements for a reference to a Place
formed_by json object Optional A json object representing the formation of the group, which follows the requirements for Formations described below.
dissolved_by json object Optional A json object representing the dissolution of the group, which follows the requirements for Dissolutions described below.

Properties of Formations, Dissolutions and Professional Activities

Property Name Datatype Requirement Description
id string Optional If present, the value MUST be a URI identifying the formation, dissolution or professional activity
type string Required The class for the birth, death or professional activity, which MUST be the value "Formation", "Dissolution", or "Activity" respectively
_label string Recommended A human readable label for the event, intended for developers
identified_by array Recommended An array of json objects, each of which is a name for the event and MUST follow the requirements for Name, or an identifier for the event and MUST follow the requirements for Identifier
classified_as array Recommended An array of json objects, each of which is a further classification of the event and MUST follow the requirements for Type
timespan json object Recommended A json object recording when the event occured, which MUST follow the requirements for timespans
referred_to_by array Optional An array of json objects, each of which is an embedded statement about the event
took_place_at array Optional An array of json objects, each of which is a reference to a Place where the event occured
caused_by array Optional An array of json objects, each of which is a reference to an Event that caused the current event to occur
influenced_by array Optional An array of json objects, each of which is an entity referece to an entity that influenced the event in some noticable fashion

Property Diagram

diagram

JSON Schema

See the schema documentation and the schema itself

Incoming Properties

Group instances are typically found as the object of the following properties, other than the self-referential properties above. This list is not exhaustive, but is intended to cover the likely cases where other endpoints refer to groups.

Property Name Source Endpoint Description
member_of Person, Group People that are members of the current Group are recorded in the Person record
carried_out_by All An activity that the Group carried out
current_owner Object An object owned by the Group
current_custodian Object An object in the custody of the Group
current_permanent_custodian Object An object that is normally in the custody of the Group
represents Visual Work Image content which represents the Group (the inverse of representation)
about Textual Work Textual content that is about the Group
transferred_custody_to Provenance The activity of transferring custody of an object to the Group
transferred_custody_from Provenance The activity of transferring custody of an object away from the Group
transferred_title_to Provenance The activity of transferring ownership of an object to the Group
transferred_title_from Provenance The activity of transferring ownership of an object away from the Group
paid_to Provenance The activity of paying money to the Group from someone else
paid_from Provenance The activity of paying money from the Group to someone else

Example

The JSON for a Group entry for the Camden Town Group could be as below.

{
  "@context": "https://linked.art/ns/v1/linked-art.json",
  "id": "https://linked.art/example/group/0",
  "type": "Group",
  "_label": "Camden Town Group",
  "classified_as": [
    {
      "id": "http://vocab.getty.edu/aat/300026009",
      "type": "Type",
      "_label": "Society"
    },
    {
      "id": "http://vocab.getty.edu/aat/300111159",
      "type": "Type",
      "_label": "British",
      "classified_as": [
        {
          "id": "http://vocab.getty.edu/aat/300379842",
          "type": "Type",
          "_label": "Nationality"
        }
      ]
    }
  ],
  "identified_by": [
    {
      "type": "Name",
      "content": "Camden Town Group",
      "language": [
        {
          "id": "http://vocab.getty.edu/aat/300388277",
          "type": "Language",
          "_label": "English"
        }
      ]
    }
  ],
  "referred_to_by": [
    {
      "type": "LinguisticObject",
      "classified_as": [
        {
          "id": "http://vocab.getty.edu/aat/300435422",
          "type": "Type",
          "_label": "Biography Statement",
          "classified_as": [
            {
              "id": "http://vocab.getty.edu/aat/300418049",
              "type": "Type",
              "_label": "Brief Text"
            }
          ]
        }
      ],
      "content": "A group of British painters formed in 1911; although it only lasted two years, its name is used in a broader sense to characterize a particular strain of British painting from about 1905 to 1920."
    }
  ],
  "carried_out": [
    {
      "type": "Activity",
      "_label": "Active Dates",
      "classified_as": [
        {
          "id": "http://vocab.getty.edu/aat/300393177",
          "type": "Type",
          "_label": "Professional Activities"
        }
      ],
      "timespan": {
        "type": "TimeSpan",
        "begin_of_the_begin": "1911-01-01T00:00:00Z",
        "end_of_the_end": "1913-12-31T23:59:59Z"
      }
    }
  ],
  "formed_by": {
    "type": "Formation",
    "_label": "Formation of the Group",
    "timespan": {
      "type": "TimeSpan",
      "_label": "1911",
      "begin_of_the_begin": "1911-01-01T00:00:00Z",
      "end_of_the_end": "1911-12-31T23:59:59Z"
    },
    "took_place_at": [
      {
        "type": "Place",
        "_label": "London"
      }
    ]
  },
  "dissolved_by": {
    "type": "Dissolution",
    "_label": "Dissolution of the Group",
    "timespan": {
      "type": "TimeSpan",
      "_label": "1913",
      "begin_of_the_begin": "1913-01-01T00:00:00Z",
      "end_of_the_end": "1913-12-31T23:59:59Z"
    },
    "took_place_at": [
      {
        "type": "Place",
        "_label": "London"
      }
    ]
  },
  "residence": [
    {
      "type": "Place",
      "_label": "London"
    }
  ],
  "equivalent": [
    {
      "id": "http://vocab.getty.edu/ulan/500117318",
      "type": "Group",
      "_label": "Camden Town Group"
    }
  ],
  "attributed_by": [
    {
      "type": "AttributeAssignment",
      "_label": "Related Group",
      "assigned": [
        {
          "id": "http://vocab.getty.edu/ulan/500117319",
          "type": "Group",
          "_label": "London Group"
        }
      ]
    }
  ]
}

graph TD classDef object stroke:black,fill:#E1BA9C,rx:20px,ry:20px; classDef actor stroke:black,fill:#FFBDCA,rx:20px,ry:20px; classDef type stroke:red,fill:#FAB565,rx:20px,ry:20px; classDef name stroke:orange,fill:#FEF3BA,rx:20px,ry:20px; classDef dims stroke:black,fill:#c6c6c6,rx:20px,ry:20px; classDef infoobj stroke:#907010,fill:#fffa40,rx:20px,ry:20px classDef timespan stroke:blue,fill:#ddfffe,rx:20px,ry:20px classDef place stroke:#3a7a3a,fill:#aff090,rx:20px,ry:20px classDef event stroke:#1010FF,fill:#96e0f6,rx:20px,ry:20px classDef literal stroke:black,fill:#f0f0e0; classDef classstyle stroke:black,fill:white; O1(group0) class O1 actor; O1-- type -->O1_0[Group] class O1_0 classstyle; O1-- _label -->O1_4("''Camden Town Group''") class O1_4 literal; O2(aat:300026009) class O2 type; O2-- type -->O2_0[Type] class O2_0 classstyle; O2-- _label -->O2_3("''Society''") class O2_3 literal; O1-- classified_as -->O2 O3(aat:300111159) class O3 type; O3-- type -->O3_0[Type] class O3_0 classstyle; O3-- _label -->O3_3("''British''") class O3_3 literal; O4(aat:300379842) class O4 type; O4-- type -->O4_0[Type] class O4_0 classstyle; O4-- _label -->O4_3("''Nationality''") class O4_3 literal; O3-- classified_as -->O4 O1-- classified_as -->O3 O5( _ ) class O5 name; O5-- type -->O5_0[Name] class O5_0 classstyle; O5-- content -->O5_2("''Camden Town Group''") class O5_2 literal; O6(aat:300388277) class O6 type; O6-- type -->O6_0[Language] class O6_0 classstyle; O6-- _label -->O6_3("''English''") class O6_3 literal; O5-- language -->O6 O1-- identified_by -->O5 O7( _ ) class O7 infoobj; O7-- type -->O7_0[LinguisticObject] class O7_0 classstyle; O8(aat:300435422) class O8 type; O8-- type -->O8_0[Type] class O8_0 classstyle; O8-- _label -->O8_3("''Biography Statement''") class O8_3 literal; O9(aat:300418049) class O9 type; O9-- type -->O9_0[Type] class O9_0 classstyle; O9-- _label -->O9_3("''Brief Text''") class O9_3 literal; O8-- classified_as -->O9 O7-- classified_as -->O8 O7-- content -->O7_3("''A group of British painters formed in 1911; although it only lasted two years, its name is used in a broader sense to characterize a particular strain of British painting from about 1905 to 1920.''") class O7_3 literal; O1-- referred_to_by -->O7 O10( _ ) class O10 event; O10-- type -->O10_0[Activity] class O10_0 classstyle; O10-- _label -->O10_2("''Active Dates''") class O10_2 literal; O11(aat:300393177) class O11 type; O11-- type -->O11_0[Type] class O11_0 classstyle; O11-- _label -->O11_3("''Professional Activities''") class O11_3 literal; O10-- classified_as -->O11 O12( _ ) class O12 timespan; O12-- type -->O12_0[TimeSpan] class O12_0 classstyle; O12-- begin_of_the_begin -->O12_2("''1911-01-01T00:00:00Z''") class O12_2 literal; O12-- end_of_the_end -->O12_3("''1913-12-31T23:59:59Z''") class O12_3 literal; O10-- timespan -->O12 O1-- carried_out -->O10 O13( _ ) class O13 event; O13-- type -->O13_0[Formation] class O13_0 classstyle; O13-- _label -->O13_2("''Formation of the Group''") class O13_2 literal; O14( _ ) class O14 timespan; O14-- type -->O14_0[TimeSpan] class O14_0 classstyle; O14-- _label -->O14_2("''1911''") class O14_2 literal; O14-- begin_of_the_begin -->O14_3("''1911-01-01T00:00:00Z''") class O14_3 literal; O14-- end_of_the_end -->O14_4("''1911-12-31T23:59:59Z''") class O14_4 literal; O13-- timespan -->O14 O15( _ ) class O15 place; O15-- type -->O15_0[Place] class O15_0 classstyle; O15-- _label -->O15_2("''London''") class O15_2 literal; O13-- took_place_at -->O15 O1-- formed_by -->O13 O16( _ ) class O16 event; O16-- type -->O16_0[Dissolution] class O16_0 classstyle; O16-- _label -->O16_2("''Dissolution of the Group''") class O16_2 literal; O17( _ ) class O17 timespan; O17-- type -->O17_0[TimeSpan] class O17_0 classstyle; O17-- _label -->O17_2("''1913''") class O17_2 literal; O17-- begin_of_the_begin -->O17_3("''1913-01-01T00:00:00Z''") class O17_3 literal; O17-- end_of_the_end -->O17_4("''1913-12-31T23:59:59Z''") class O17_4 literal; O16-- timespan -->O17 O18( _ ) class O18 place; O18-- type -->O18_0[Place] class O18_0 classstyle; O18-- _label -->O18_2("''London''") class O18_2 literal; O16-- took_place_at -->O18 O1-- dissolved_by -->O16 O19( _ ) class O19 place; O19-- type -->O19_0[Place] class O19_0 classstyle; O19-- _label -->O19_2("''London''") class O19_2 literal; O1-- residence -->O19 O20(ulan:500117318) class O20 actor; O20-- type -->O20_0[Group] class O20_0 classstyle; O20-- _label -->O20_3("''Camden Town Group''") class O20_3 literal; O1-- equivalent -->O20 O21( _ ) class O21 event; O21-- type -->O21_0[AttributeAssignment] class O21_0 classstyle; O21-- _label -->O21_2("''Related Group''") class O21_2 literal; O22(ulan:500117319) class O22 actor; O22-- type -->O22_0[Group] class O22_0 classstyle; O22-- _label -->O22_3("''London Group''") class O22_3 literal; O21-- assigned -->O22 O1-- attributed_by -->O21
Other Representations: JSON-LD (raw) | JSON-LD (playground) | Turtle (raw) | Turtle (styled)