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

Example

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

• It has the Linked Art context reference in @context
• It self-documents its URI in id
• It has a type of "Person"
• It has a _label with the value "Rembrandt" for humans reading the JSON
• It has a classified_as property with entries for ...
  • ... Male, which is in turn classified_as a Gender
  • ... Dutch, which is in turn classified_as a Nationality
• It has an identified_by property, with a Name for his full name of "Rembrandt Harmenszoon van Rijn"
• It has a referred_to_by for a statement, classified_as a Biography
• It has a born property for his birth, with a timespan and a location in took_place_at.
• It has a died property for his death, with a timespan and a location in took_place_at.
• It has a carried_out for his professional activity, again with timespan and took_place_at properties, but also classified_as being professional activities
• It has an equivalent to his ULAN identity
• It has a residence with a reference to the Place where he lived
• It has a contact_point for his former street address

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