Events

Introduction

The Event API is a method of getting access to descriptions of periods of time, events or activities that are not directly associated with other entities, nor are provenance activities or exhibitions, but are still noteworthy occurences somehow related to artwork. Examples might include a fire that burnt down a museum, thereby causing the destruction of many works of art, a project that researched aspects of works of art, or a named period during which objects were created. Although these are different classes, they are so similar in this usage that they are grouped together into a single endpoint from the perspective of the API. The Event API is of average complexity with many familiar properties and patterns of other endpoints, plus the event and activity properties familiar from embedded events.

Property Definitions

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

Properties of Events

Property Diagram

JSON Schema

See the schema documentation and the schema itself

Incoming Properties

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

Example

The JSON for an Event describing an auction in 1820 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 "Activity" (as it is carried out by some Group, thus it is not an Event or Period)
• It has a _label with the value "Foster Auction of March 1820" for people reading the JSON
• It is classified_as an "Auction Event", which has an id of "aat:300054751"
• It is identified_by ...
  • ... a Name, with the content "Edward Foster Auction of March 1820"
  • ... and an Identifier, with the content "Br1908", which is classified_as an Owner-Assigned number ("aat:300404621")
• It is referred_to_by a statement which ...
  • ... has content of "Besides paintings, this sale ..."
  • ... is classified_as a Description ("aat:300435416")
• It has a timespan which ...
  • ... has a display title, with the content "1820 Mar 09"
  • ... has a begin_of_the_begin with the value "1820-03-09T00:00:00Z" (the earliest possible time on March 9th)
  • ... has an end_of_the_end with the value "1820-03-09T23:59:59Z" (the latest possible time on March 9th)
• It took_place_at London
• It was carried_out_by the Group "Edward Foster & Son"
• It used_specific_object of a Set, encompassing all of the auction lots
• It is equivalent to another description of the same event at example.auction
• It is the subject_of the text of a Sales Catalog

{
  "@context": "https://linked.art/ns/v1/linked-art.json",
  "id": "https://linked.art/example/event/0",
  "type": "Activity",
  "_label": "Foster Auction of March 1820",
  "classified_as": [
    {
      "id": "http://vocab.getty.edu/aat/300054751",
      "type": "Type",
      "_label": "Auction Event"
    }
  ],
  "identified_by": [
    {
      "type": "Name",
      "content": "Edward Foster Auction of March 1820"
    },
    {
      "type": "Identifier",
      "classified_as": [
        {
          "id": "http://vocab.getty.edu/aat/300404621",
          "type": "Type",
          "_label": "Owner-Assigned Number"
        }
      ],
      "content": "Br1908"
    }
  ],
  "referred_to_by": [
    {
      "type": "LinguisticObject",
      "classified_as": [
        {
          "id": "http://vocab.getty.edu/aat/300435416",
          "type": "Type",
          "_label": "Description",
          "classified_as": [
            {
              "id": "http://vocab.getty.edu/aat/300418049",
              "type": "Type",
              "_label": "Brief Text"
            }
          ]
        }
      ],
      "content": "Besides paintings, this sale included a few lots with musical instruments and watches. The owners were a number of dealers who regularly consigned their wares to this auctioneer, despite the fact that the title page names \"A Gentleman\" as the owner."
    }
  ],
  "timespan": {
    "type": "TimeSpan",
    "identified_by": [
      {
        "type": "Name",
        "classified_as": [
          {
            "id": "http://vocab.getty.edu/aat/300404669",
            "type": "Type",
            "_label": "Display Title"
          }
        ],
        "content": "1820 Mar 09"
      }
    ],
    "begin_of_the_begin": "1820-03-09T00:00:00Z",
    "end_of_the_end": "1820-03-09T23:59:59Z"
  },
  "took_place_at": [
    {
      "id": "http://vocab.getty.edu/tgn/7011781",
      "type": "Place",
      "_label": "London"
    }
  ],
  "carried_out_by": [
    {
      "id": "http://vocab.getty.edu/ulan/500451765",
      "type": "Group",
      "_label": "Edward Foster & Son"
    }
  ],
  "used_specific_object": [
    {
      "id": "http://example.org/sets/Br1908",
      "type": "Set",
      "_label": "All Auction Lots of Br1908"
    }
  ],
  "equivalent": [
    {
      "id": "http://example.auction/past/foster/1820/03/1",
      "type": "Activity"
    }
  ],
  "subject_of": [
    {
      "id": "http://example.org/catalog/Br1908",
      "type": "LinguisticObject",
      "_label": "Sales Catalog of Br-1908"
    }
  ]
}