Linked Art API: Statement Structure

Table of Contents

Introduction
Property Definitions
Example

Introduction

Statements are a human-readable expression of the content or note about the entity being referred to. Even if there are structured forms of the resources, these textual descriptions are useful to render to end users. They can have both internationalized content, as well as internationalized labels in the form of Name instances associated with them. These statements are embedded within the resource being described, rather than separate long form texts.

Statements are described in the base patterns of the model documentation, and examples are present for practically every class.

Property Definitions

Properties of Names

Property Name	Datatype	Requirement	Description
`id`	string	Optional	If present, the value MUST be a URI identifying the statement, from which a representation of the statement can be retrieved
`type`	string	Required	The class for the statement, which MUST be the value `"LinguisticObject"`
`_label`	string	Optional	A human readable label, intended for developers
`_complete`	boolean	Optional	Non-Semantic. If there is an `id` property with a URI, and there is more information about the statement available from the representation at that URI, then `_complete` MUST be present with a value of `false` to inform the consuming application that it might want to retrieve it
`content`	string	Required	The string value of the statement
`classified_as`	array	Recommended	An array of json objects, each of which is a further classification of the statement and MUST follow the requirements for Type
`language`	array	Recommended	An array of json objects, each of which is a language present in the content of the statement and MUST follow the requirements for Language
`identified_by`	array	Recommended	An array of json objects, each of which is a label or name for the statement, and MUST follow the requirements for Name
`referred_to_by`	array	Optional	An array of json objects, each of which is either a reference to a textual work that refers to this statement, or an embedded statement about this statement
`format`	string	Optional	If the string in content is not plain text, then format can be used to specify the media type of the string
`assigned_by`	array	Optional	An array of json objects, each of which is an assignment of the statement, and MUST follow the requirements for Assignments
`subject_to`	array	Optional	An array of json objects, each of which is a Right that is held over the statement
`created_by`	json object	Optional	A json object representing the creation of the statement, which follows the requirements for a Creation

Property Diagram

Incoming Properties

Statements are typically found as the object of the following properties. This list is not exhaustive, but is intended to cover the most likely cases.

Property Name	Source Endpoint	Description
`referred_to_by`	All	Statements are almost always found in the `referred_to_by` property, and can be present in any of the API endpoints

Example

An object is referred_to_by a Description in English.

The description has a type of "LinguisticObject"
It is classified_as a description, with an id of aat:300435416 and type of "Type". The description concept is in turn classified_as a type of "brief text"
It has content of "A small greenstone pendant..."
It is identified_by a display label, which has a type of "Name", and content of "Description"
It has a language of English, which has an id of aat:300388277
It has a statement about the description, saying that it was provided by the artist.
It is subject_to a Right, which is Creative Commons Attribution Required, version 4.0

{
  "@context": "https://linked.art/ns/v1/linked-art.json",
  "id": "https://linked.art/example/object/12",
  "type": "HumanMadeObject",
  "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": "A small greenstone pendant surrounded by silver",
      "identified_by": [
        {
          "type": "Name",
          "classified_as": [
            {
              "id": "http://vocab.getty.edu/aat/300404669",
              "type": "Type",
              "_label": "Display Title"
            }
          ],
          "content": "Description"
        }
      ],
      "referred_to_by": [
        {
          "type": "LinguisticObject",
          "content": "Description provided by the artist"
        }
      ],
      "language": [
        {
          "id": "http://vocab.getty.edu/aat/300388277",
          "type": "Language",
          "_label": "English"
        }
      ],
      "subject_to": [
        {
          "type": "Right",
          "classified_as": [
            {
              "id": "https://creativecommons.org/licenses/by/4.0/",
              "type": "Type"
            }
          ],
          "identified_by": [
            {
              "type": "Name",
              "classified_as": [
                {
                  "id": "http://vocab.getty.edu/aat/300404669",
                  "type": "Type",
                  "_label": "Display Title"
                }
              ],
              "content": "CC BY 4.0"
            }
          ]
        }
      ]
    }
  ]
}

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(object/12) class O1 object; O1-- type -->O1_0[HumanMadeObject] class O1_0 classstyle; O2( _ ) class O2 infoobj; O2-- type -->O2_0[LinguisticObject] class O2_0 classstyle; O3(aat:300435416) class O3 type; O3-- type -->O3_0[Type] class O3_0 classstyle; O3-- _label -->O3_3("''Description''") class O3_3 literal; O4(aat:300418049) class O4 type; O4-- type -->O4_0[Type] class O4_0 classstyle; O4-- _label -->O4_3("''Brief Text''") class O4_3 literal; O3-- classified_as -->O4 O2-- classified_as -->O3 O2-- content -->O2_3("''A small greenstone pendant surrounded by silver''") class O2_3 literal; O5( _ ) class O5 name; O5-- type -->O5_0[Name] class O5_0 classstyle; O6(aat:300404669) class O6 type; O6-- type -->O6_0[Type] class O6_0 classstyle; O6-- _label -->O6_3("''Display Title''") class O6_3 literal; O5-- classified_as -->O6 O5-- content -->O5_3("''Description''") class O5_3 literal; O2-- identified_by -->O5 O7( _ ) class O7 infoobj; O7-- type -->O7_0[LinguisticObject] class O7_0 classstyle; O7-- content -->O7_2("''Description provided by the artist''") class O7_2 literal; O2-- referred_to_by -->O7 O8(aat:300388277) class O8 type; O8-- type -->O8_0[Language] class O8_0 classstyle; O8-- _label -->O8_3("''English''") class O8_3 literal; O2-- language -->O8 O9( _ ) class O9 infoobj; O9-- type -->O9_0[Right] class O9_0 classstyle; O10(https://creativecommons.org/licenses/by/4.0/) class O10 type; O10-- type -->O10_0[Type] class O10_0 classstyle; O9-- classified_as -->O10 O11( _ ) class O11 name; O11-- type -->O11_0[Name] class O11_0 classstyle; O11-- classified_as -->O6 O11-- content -->O11_3("''CC BY 4.0''") class O11_3 literal; O9-- identified_by -->O11 O2-- subject_to -->O9 O1-- referred_to_by -->O2

Other Representations: JSON-LD (raw) | JSON-LD (playground) | Turtle (raw) | Turtle (styled)