Linked Art API: Person

Introduction

The Person API is a method of getting access to descriptions of people, living or dead. This would include artists and collectors, but also museum staff such as curators or conservators that perform their professional activities on or using artwork. The Person model is of average complexity, with many familiar properties and patterns, plus a few more specific fields. This results in an average complexity API that can result in reasonably long JSON responses if all of the fields have values.

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

Property Definitions

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

Properties of People

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 person's representation can be dereferenced
type string Required The class for the person, which MUST be the value "Person"
_label string Recommended A human readable label for the person, intended for developers
classified_as array Recommended An array of json objects, each of which is a classification of the person and MUST follow the requirements for Type
identified_by array Recommended An array of json objects, each of which is a name of the person and MUST follow the requirements for Name, or an identifier for the person 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 person 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 Person
representation array Optional An array of json objects, each of which is a reference to a Visual Work that represents the current Person, 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 Person 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 Person, 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 Person to another entity
carried_out array Optional An array of json objects, each of which represents professional activities of the person 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 person is reachable and MUST follow the requirements for an Identifier
residence array Optional A place that the person was associated with, and MUST follow the requirements for a reference to a Place
born json object Optional A json object representing the birth of the person, which follows the requirements for Births described below.
died json object Optional A json object representing the death of the person, which follows the requirements for Deaths described below.

Properties of Births, Deaths and Professional Activities

Property Name Datatype Requirement Description
id string Optional If present, the value MUST be a URI identifying the birth, death or professional activity
type string Required The class for the birth, death or professional activity, which MUST be the value "Birth", "Death", 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 measurement
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

Property Diagram

diagram

JSON Schema

See the schema documentation and the schema itself

Incoming Properties

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

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

Example

The JSON for a Person entry for the artist Rembrandt could be as below.

{
  "@context": "https://linked.art/ns/v1/linked-art.json",
  "id": "https://linked.art/example/person/0",
  "type": "Person",
  "_label": "Rembrandt",
  "classified_as": [
    {
      "id": "http://vocab.getty.edu/aat/300189559",
      "type": "Type",
      "_label": "Male",
      "classified_as": [
        {
          "id": "http://vocab.getty.edu/aat/300055147",
          "type": "Type",
          "_label": "Gender"
        }
      ]
    },
    {
      "id": "http://vocab.getty.edu/aat/300111175",
      "type": "Type",
      "_label": "Dutch",
      "classified_as": [
        {
          "id": "http://vocab.getty.edu/aat/300379842",
          "type": "Type",
          "_label": "Nationality"
        }
      ]
    }
  ],
  "identified_by": [
    {
      "type": "Name",
      "content": "Rembrandt Harmenszoon van Rijn"
    }
  ],
  "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": "Rembrandt was a Dutch draughtsman, painter and printmaker."
    }
  ],
  "born": {
    "type": "Birth",
    "_label": "Birth of Rembrandt",
    "timespan": {
      "type": "TimeSpan",
      "begin_of_the_begin": "1606-07-15T00:00:00Z",
      "end_of_the_end": "1606-07-16T00:00:00Z"
    },
    "took_place_at": [
      {
        "type": "Place",
        "_label": "Leiden"
      }
    ]
  },
  "died": {
    "type": "Death",
    "_label": "Death of Rembrandt",
    "timespan": {
      "type": "TimeSpan",
      "begin_of_the_begin": "1669-10-04T00:00:00Z",
      "end_of_the_end": "1669-10-05T00:00:00Z"
    },
    "took_place_at": [
      {
        "type": "Place",
        "_label": "Amsterdam"
      }
    ]
  },
  "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": "1631-01-01T00:00:00Z",
        "end_of_the_end": "1669-10-05T00:00:00Z"
      },
      "took_place_at": [
        {
          "type": "Place",
          "_label": "Amsterdam"
        }
      ]
    }
  ],
  "residence": [
    {
      "type": "Place",
      "_label": "Nieuwe Doelenstraat"
    }
  ],
  "contact_point": [
    {
      "type": "Identifier",
      "classified_as": [
        {
          "id": "http://vocab.getty.edu/aat/300386983",
          "type": "Type",
          "_label": "Street Address"
        }
      ],
      "content": "Jodenbreestraat 4, 1011NK Amsterdam"
    }
  ],
  "equivalent": [
    {
      "id": "http://vocab.getty.edu/ulan/500011051",
      "type": "Person",
      "_label": "Rembrandt"
    }
  ]
}

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(person/0) class O1 actor; O1-- type -->O1_0[Person] class O1_0 classstyle; O1-- _label -->O1_4("''Rembrandt''") class O1_4 literal; O2(aat:300189559) class O2 type; O2-- type -->O2_0[Type] class O2_0 classstyle; O2-- _label -->O2_3("''Male''") class O2_3 literal; O3(aat:300055147) class O3 type; O3-- type -->O3_0[Type] class O3_0 classstyle; O3-- _label -->O3_3("''Gender''") class O3_3 literal; O2-- classified_as -->O3 O1-- classified_as -->O2 O4(aat:300111175) class O4 type; O4-- type -->O4_0[Type] class O4_0 classstyle; O4-- _label -->O4_3("''Dutch''") class O4_3 literal; O5(aat:300379842) class O5 type; O5-- type -->O5_0[Type] class O5_0 classstyle; O5-- _label -->O5_3("''Nationality''") class O5_3 literal; O4-- classified_as -->O5 O1-- classified_as -->O4 O6( _ ) class O6 name; O6-- type -->O6_0[Name] class O6_0 classstyle; O6-- content -->O6_2("''Rembrandt Harmenszoon van Rijn''") class O6_2 literal; O1-- identified_by -->O6 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("''Rembrandt was a Dutch draughtsman, painter and printmaker.''") class O7_3 literal; O1-- referred_to_by -->O7 O10( _ ) class O10 event; O10-- type -->O10_0[Birth] class O10_0 classstyle; O10-- _label -->O10_2("''Birth of Rembrandt''") class O10_2 literal; O11( _ ) class O11 timespan; O11-- type -->O11_0[TimeSpan] class O11_0 classstyle; O11-- begin_of_the_begin -->O11_2("''1606-07-15T00:00:00Z''") class O11_2 literal; O11-- end_of_the_end -->O11_3("''1606-07-16T00:00:00Z''") class O11_3 literal; O10-- timespan -->O11 O12( _ ) class O12 place; O12-- type -->O12_0[Place] class O12_0 classstyle; O12-- _label -->O12_2("''Leiden''") class O12_2 literal; O10-- took_place_at -->O12 O1-- born -->O10 O13( _ ) class O13 event; O13-- type -->O13_0[Death] class O13_0 classstyle; O13-- _label -->O13_2("''Death of Rembrandt''") class O13_2 literal; O14( _ ) class O14 timespan; O14-- type -->O14_0[TimeSpan] class O14_0 classstyle; O14-- begin_of_the_begin -->O14_2("''1669-10-04T00:00:00Z''") class O14_2 literal; O14-- end_of_the_end -->O14_3("''1669-10-05T00:00:00Z''") class O14_3 literal; O13-- timespan -->O14 O15( _ ) class O15 place; O15-- type -->O15_0[Place] class O15_0 classstyle; O15-- _label -->O15_2("''Amsterdam''") class O15_2 literal; O13-- took_place_at -->O15 O1-- died -->O13 O16( _ ) class O16 event; O16-- type -->O16_0[Activity] class O16_0 classstyle; O16-- _label -->O16_2("''Active Dates''") class O16_2 literal; O17(aat:300393177) class O17 type; O17-- type -->O17_0[Type] class O17_0 classstyle; O17-- _label -->O17_3("''Professional Activities''") class O17_3 literal; O16-- classified_as -->O17 O18( _ ) class O18 timespan; O18-- type -->O18_0[TimeSpan] class O18_0 classstyle; O18-- begin_of_the_begin -->O18_2("''1631-01-01T00:00:00Z''") class O18_2 literal; O18-- end_of_the_end -->O18_3("''1669-10-05T00:00:00Z''") class O18_3 literal; O16-- timespan -->O18 O19( _ ) class O19 place; O19-- type -->O19_0[Place] class O19_0 classstyle; O19-- _label -->O19_2("''Amsterdam''") class O19_2 literal; O16-- took_place_at -->O19 O1-- carried_out -->O16 O20( _ ) class O20 place; O20-- type -->O20_0[Place] class O20_0 classstyle; O20-- _label -->O20_2("''Nieuwe Doelenstraat''") class O20_2 literal; O1-- residence -->O20 O21( _ ) class O21 name; O21-- type -->O21_0[Identifier] class O21_0 classstyle; O22(aat:300386983) class O22 type; O22-- type -->O22_0[Type] class O22_0 classstyle; O22-- _label -->O22_3("''Street Address''") class O22_3 literal; O21-- classified_as -->O22 O21-- content -->O21_3("''Jodenbreestraat 4, 1011NK Amsterdam''") class O21_3 literal; O1-- contact_point -->O21 O23(ulan:500011051) class O23 actor; O23-- type -->O23_0[Person] class O23_0 classstyle; O23-- _label -->O23_3("''Rembrandt''") class O23_3 literal; O1-- equivalent -->O23
Other Representations: JSON-LD (raw) | JSON-LD (playground) | Turtle (raw) | Turtle (styled)