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

Example

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

• It has the Linked Art context document reference in @context
• It self-documents its URI in id
• It has a type of "Group"
• It has a _label with the value "Camden Town Group" for people reading the JSON
• It is classified_as ...
  • ... a "Society", which has an id of "aat:300026009"
  • ... "British", which as an id of "aat:300111159" and a meta-type of "Nationality", which has an id of "aat:300379842"
• It is identified_by a Name, with the content "Camden Town Group", and language of English ("aat:300388277")
• It is referred_to_by a statement which ...
  • ... has content of "A group of British painters formed in 1911 ..."
  • ... is classified_as a Biography ("aat:300435422")
• It carried_out its professional activities ...
  • ... in a timespan between "1911-01-01" and "1913-12-31"
• It is attributed_by an "AttributeAssignment" relationship
  • ... to the London Group, with id "ulan:500117319"
• It has a residence of London
• It is equivalent to the ULAN entry `"ulan:500117318"
• It was formed_by a Formation which ...
  • ... took_place_at London
  • ... in a timespan between "1911-01-01" and "1911-12-31"
• It was dissolved_by a Dissolution which ...
  • ... took_place_at London again
  • ... in a timespan between "1913-01-01" and "1913-12-31"

{
  "@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"
        }
      ]
    }
  ]
}