Linked Art API: Statement Structure

Table of Contents

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

Property Diagram

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

(And that's all!)

Example

An object is referred_to_by a Description in English.

{
  "@context": "https://linked.art/ns/v1/linked-art.json",
  "id": "https://linked.art/example/object/11",
  "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"
        }
      ]
    }
  ]
}

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/11) 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 O1-- referred_to_by -->O2
Other Representations: JSON-LD (raw) | JSON-LD (playground) | Turtle (raw) | Turtle (styled)