{"id":"linked-art/api/events","relativePath":"linked-art/api/events.md","title":"Linked Art API: Events","markdown":"# Linked Art API: Events\n\n**Last refreshed:** 2026-07-06\n\nSource: [Events endpoint](https://linked.art/api/1.0/endpoint/event/), part of Linked Art API 1.0, published under [CC BY 4.0](http://creativecommons.org/licenses/by/4.0/). This is a project summary; the upstream page is authoritative.\n\n## Purpose\n\nThe Event endpoint describes standalone periods, events, and activities that are noteworthy but are not directly embedded in another entity endpoint, are not provenance activities, and are not exhibitions. Examples include named periods, fires or other events that caused destruction, research projects, and auction or other activities related to works of art.\n\nLinked Art groups `Period`, `Event`, and `Activity` into this one endpoint because they share many properties in API use.\n\n## Required Shape\n\nAn Event endpoint record dereferences to one JSON-LD object:\n\n- `@context`: Linked Art context URI, or an array ending with that URI for extensions.\n- `id`: dereferenceable HTTP(S) URI for the event.\n- `type`: one of `Period`, `Event`, or `Activity`.\n\n## Recommended Fields\n\n- `_label`: developer-facing label.\n- `classified_as`: classifications following the `Type` structure.\n- `identified_by`: `Name` and/or `Identifier` structures.\n- `timespan`: `TimeSpan` structure recording when the event occurred.\n\n## Optional Shared Fields\n\n- `referred_to_by`: human-readable statements.\n- `equivalent`: external identities.\n- `representation`: visual works representing the event.\n- `member_of`: sets that include the event.\n- `subject_of`: textual works focused on the event.\n- `attributed_by`: relationship assignment evidence.\n- `part_of`: broader event that directly contains this event.\n- `during`: broader period during which this event occurred.\n- `before`: period, event, or activity after this event in relative order.\n- `after`: period, event, or activity before this event in relative order.\n- `took_place_at`: places where the event occurred.\n\n## Type-Specific Fields\n\nOnly `Event` and `Activity` use:\n\n- `caused_by`: event that caused this event or activity.\n- `participant`: people or groups that participated but did not carry it out.\n\nOnly `Activity` uses:\n\n- `influenced_by`: entity that influenced the activity.\n- `carried_out_by`: person or group responsible for carrying out the activity.\n- `used_specific_object`: entity instrumental in carrying out the activity.\n- `technique`: technique used in the activity, modeled as `Type`.\n\n## Common Incoming Relationships\n\n- `part_of` from events or activities in any endpoint. This implies the broader event's spatial and temporal constraints also apply to the referencing event or activity.\n\n## Meta Museum Notes\n\nMeta Museum already exposes `/api/events/{id}` as a canonical role route for `Period`, `Event`, and `Activity`. Existing record and role-route tests preserve names, timespans, places, actor responsibility, `caused_by`, `part_of`, `during`, `before`, and `after`. Activity-stream projections also preserve standalone semantic event relationships when they appear on stored records.\n\n## Test Ideas\n\n- Keep `/api/events/{id}` role coverage aligned with exactly `Period`, `Event`, and `Activity`.\n- Preserve an `Activity` fixture with `carried_out_by`, `used_specific_object`, `technique`, `took_place_at`, `subject_of`, and `timespan`.\n- Preserve an `Event` fixture with `caused_by`, `participant`, and `part_of`.\n- Preserve a `Period` fixture with `timespan`, `during`, `before`, and `after`, while avoiding `carried_out_by` on pure periods.\n","sections":[{"level":2,"heading":"Purpose","anchor":"purpose"},{"level":2,"heading":"Required Shape","anchor":"required-shape"},{"level":2,"heading":"Recommended Fields","anchor":"recommended-fields"},{"level":2,"heading":"Optional Shared Fields","anchor":"optional-shared-fields"},{"level":2,"heading":"Type-Specific Fields","anchor":"type-specific-fields"},{"level":2,"heading":"Common Incoming Relationships","anchor":"common-incoming-relationships"},{"level":2,"heading":"Meta Museum Notes","anchor":"meta-museum-notes"},{"level":2,"heading":"Test Ideas","anchor":"test-ideas"}],"html":"<h1 id=\"linked-art-api-events\">Linked Art API: Events</h1>\n<p><strong>Last refreshed:</strong> 2026-07-06</p>\n<p>Source: <a href=\"https://linked.art/api/1.0/endpoint/event/\" target=\"_blank\" rel=\"noopener noreferrer\" class=\"doc-link\">Events endpoint</a>, part of Linked Art API 1.0, published under <a href=\"http://creativecommons.org/licenses/by/4.0/\" target=\"_blank\" rel=\"noopener noreferrer\" class=\"doc-link\">CC BY 4.0</a>. This is a project summary; the upstream page is authoritative.</p>\n<h2 id=\"purpose\">Purpose</h2>\n<p>The Event endpoint describes standalone periods, events, and activities that are noteworthy but are not directly embedded in another entity endpoint, are not provenance activities, and are not exhibitions. Examples include named periods, fires or other events that caused destruction, research projects, and auction or other activities related to works of art.</p>\n<p>Linked Art groups `Period`, `Event`, and `Activity` into this one endpoint because they share many properties in API use.</p>\n<h2 id=\"required-shape\">Required Shape</h2>\n<p>An Event endpoint record dereferences to one JSON-LD object:</p>\n<ul><li>`@context`: Linked Art context URI, or an array ending with that URI for extensions.</li><li>`id`: dereferenceable HTTP(S) URI for the event.</li><li>`type`: one of `Period`, `Event`, or `Activity`.</li></ul>\n<h2 id=\"recommended-fields\">Recommended Fields</h2>\n<ul><li>`_label`: developer-facing label.</li><li>`classified_as`: classifications following the `Type` structure.</li><li>`identified_by`: `Name` and/or `Identifier` structures.</li><li>`timespan`: `TimeSpan` structure recording when the event occurred.</li></ul>\n<h2 id=\"optional-shared-fields\">Optional Shared Fields</h2>\n<ul><li>`referred_to_by`: human-readable statements.</li><li>`equivalent`: external identities.</li><li>`representation`: visual works representing the event.</li><li>`member_of`: sets that include the event.</li><li>`subject_of`: textual works focused on the event.</li><li>`attributed_by`: relationship assignment evidence.</li><li>`part_of`: broader event that directly contains this event.</li><li>`during`: broader period during which this event occurred.</li><li>`before`: period, event, or activity after this event in relative order.</li><li>`after`: period, event, or activity before this event in relative order.</li><li>`took_place_at`: places where the event occurred.</li></ul>\n<h2 id=\"type-specific-fields\">Type-Specific Fields</h2>\n<p>Only `Event` and `Activity` use:</p>\n<ul><li>`caused_by`: event that caused this event or activity.</li><li>`participant`: people or groups that participated but did not carry it out.</li></ul>\n<p>Only `Activity` uses:</p>\n<ul><li>`influenced_by`: entity that influenced the activity.</li><li>`carried_out_by`: person or group responsible for carrying out the activity.</li><li>`used_specific_object`: entity instrumental in carrying out the activity.</li><li>`technique`: technique used in the activity, modeled as `Type`.</li></ul>\n<h2 id=\"common-incoming-relationships\">Common Incoming Relationships</h2>\n<ul><li>`part_of` from events or activities in any endpoint. This implies the broader event&#39;s spatial and temporal constraints also apply to the referencing event or activity.</li></ul>\n<h2 id=\"meta-museum-notes\">Meta Museum Notes</h2>\n<p>Meta Museum already exposes `/api/events/{id}` as a canonical role route for `Period`, `Event`, and `Activity`. Existing record and role-route tests preserve names, timespans, places, actor responsibility, `caused_by`, `part_of`, `during`, `before`, and `after`. Activity-stream projections also preserve standalone semantic event relationships when they appear on stored records.</p>\n<h2 id=\"test-ideas\">Test Ideas</h2>\n<ul><li>Keep `/api/events/{id}` role coverage aligned with exactly `Period`, `Event`, and `Activity`.</li><li>Preserve an `Activity` fixture with `carried_out_by`, `used_specific_object`, `technique`, `took_place_at`, `subject_of`, and `timespan`.</li><li>Preserve an `Event` fixture with `caused_by`, `participant`, and `part_of`.</li><li>Preserve a `Period` fixture with `timespan`, `during`, `before`, and `after`, while avoiding `carried_out_by` on pure periods.</li></ul>","updatedAt":"2026-07-06T00:00:00.000Z","checksum":"cdb00a835694a1286c84ac604d218d57de479b5826e5e62668a2aa6d0174c828","checksumPrefix":"cdb00a835694","anchorCount":8,"lineCount":70,"rawUrl":"/api/docs/content?path=linked-art%2Fapi%2Fevents.md","htmlUrl":"/docs?doc=linked-art%2Fapi%2Fevents.md","apiUrl":"/api/docs/content?path=linked-art%2Fapi%2Fevents.md"}