Provenance Activities

Introduction

The Provenance Activity API is a method of getting access to descriptions of ... The API is of higher than average complexity with many familiar properties and patterns, but also with a series of classes which convey parts of the higher level activity, each with their own unique properties.

Property Definitions

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

Properties of Provenance Activities

The top level Activity has the following properties.

Required Classification

In order to determine that the activity is a Provenance Activity, rather than a more general Event or Activity, which would follow the event API instead, the Activity MUST have a classified_as entry with an id of "http://vocab.getty.edu/aat/300055863".

{
  "@context": "https://linked.art/ns/v1/linked-art.json",
  "id": "https://linked.art/example/provenance/0",
  "type": "Activity",
  "_label": "Provenance Activity",
  "classified_as": [
    {
      "id": "http://vocab.getty.edu/aat/300055863",
      "type": "Type",
      "_label": "Provenance Activity"
    }
  ]
}

Properties of All Parts

Each of the activities in the part property can have the properties in the table below. The different classes of activity have their own type and other properties, which are defined in the following subsections.

Properties of Part: Acquisition

Parts which are Acquisitions have the following additional properties.

Properties of Part: Payment

Parts which are Payments have the following additional properties.

Properties of Part: Transfer of Custody

Parts which are Transfers of Custody have the following additional properties.

Properties of Part: Encounter

Parts which are Encounters have the following additional properties.

Properties of Part: Right Acquisition

Parts which are Right Acquisitions have the following additional properties.

Properties of Part: Move

Parts which are Moves have the following additional properties.

Properties of Part: Promise

Parts which are Promises have the following additional properties.

Properties of Part: Transfer

Parts which are unknown types of Transfer have the following additional properties.

Properties of Rights

Property Diagram

JSON Schema

See the schema documentation and the schema itself

Incoming Properties

Provenance Activities do not have any incoming references in the current set of APIs, instead they link out to many different entities.

Example

The JSON for a Provenance Activity describing an the purchase of an object in 1820 at auction 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"
• It has a _label with the value "St George from Simpson to Adams" for people reading the JSON
• It is classified_as a "Provenance Entry", which has an id of "aat:300055863"
• It is identified_by ...
  • ... a Name, with the content "Purchase of Lot 0055a, Durer's St George and the Dragon"
  • ... and an Identifier, with the content "0055a"
• It has a timespan between "1820-03-09T00:00:00Z" and "1820-03-09T23:59:59Z"
• It took_place_at London
• It used_specific_object of the auction lot, a Set which would have the object as a member
• It consists of two part entries:
  • An Acquisition which ...
    • ... transferred_title_of the object,
    • ... transferred_title_from a Person called Simpson (the seller),
    • ... and transferred_title_to a Person called Adams (the buyer)
  • A Payment which ...
    • ... paid_amount of 8.8 British Pounds ("aat:300411998")
    • ... was paid_from Adams
    • ... was paid_to Simpson

{
  "@context": "https://linked.art/ns/v1/linked-art.json",
  "id": "https://linked.art/example/provenance/1",
  "type": "Activity",
  "_label": "St George from Simpson to Adams",
  "classified_as": [
    {
      "id": "http://vocab.getty.edu/aat/300055863",
      "type": "Type",
      "_label": "Provenance Activity"
    }
  ],
  "identified_by": [
    {
      "type": "Name",
      "content": "Purchase of Lot 0055a, Durer's St George and the Dragon"
    },
    {
      "type": "Identifier",
      "content": "0055a"
    }
  ],
  "timespan": {
    "type": "TimeSpan",
    "_label": "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/set/Br1908/0055",
      "type": "Set",
      "_label": "Set of Objects for Lot 0055"
    }
  ],
  "caused_by": [
    {
      "id": "http://example.org/auction/Br1908/0055",
      "type": "Activity",
      "_label": "Auction of Lot 0055"
    }
  ],
  "part": [
    {
      "type": "Acquisition",
      "transferred_title_of": [
        {
          "id": "http://example.museum/object/1",
          "type": "HumanMadeObject",
          "_label": "St George and the Dragon"
        }
      ],
      "transferred_title_from": [
        {
          "id": "http://example.museum/person/2",
          "type": "Person",
          "_label": "Simpson"
        }
      ],
      "transferred_title_to": [
        {
          "id": "http://example.museum/person/1",
          "type": "Person",
          "_label": "Adams"
        }
      ]
    },
    {
      "type": "Payment",
      "paid_amount": {
        "type": "MonetaryAmount",
        "_label": "8.8 pounds",
        "value": 8.8,
        "currency": {
          "id": "http://vocab.getty.edu/aat/300411998",
          "type": "Currency",
          "_label": "British Pounds"
        }
      },
      "paid_from": [
        {
          "id": "http://example.museum/person/1",
          "type": "Person",
          "_label": "Adams"
        }
      ],
      "paid_to": [
        {
          "id": "http://example.museum/person/2",
          "type": "Person",
          "_label": "Simpson"
        }
      ]
    }
  ]
}