{"id":"linked-art/api/people","relativePath":"linked-art/api/people.md","title":"Linked Art API: People","markdown":"# Linked Art API: People\n\n**Last refreshed:** 2026-07-06\n\nSource: [People endpoint](https://linked.art/api/1.0/endpoint/person/), 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 Person endpoint describes people, living or dead. This includes artists, collectors, curators, conservators, museum staff, and other people who perform professional or historical activities on or using works of art.\n\nThe endpoint is similar to the Group endpoint, but person lifecycle events use `Birth` and `Death`.\n\n## Required Shape\n\nA Person 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 person.\n- `type`: `Person`.\n\n## Recommended Fields\n\n- `_label`: developer-facing label.\n- `classified_as`: classifications following the `Type` structure, such as gender, nationality, or occupation terms.\n- `identified_by`: `Name` and/or `Identifier` structures.\n\n## Optional Fields\n\n- `referred_to_by`: statements about the person, such as biography statements.\n- `equivalent`: external identities.\n- `representation`: visual works representing the person.\n- `member_of`: group membership.\n- `subject_of`: textual works focused on the person.\n- `attributed_by`: relationship assignment evidence.\n- `contact_point`: addresses or contact identifiers.\n- `residence`: associated place.\n- `carried_out`: professional activities of the person.\n- `participated_in`: events or activities in which the person participated but was not responsible.\n- `born`: `Birth` event for the person.\n- `died`: `Death` event for the person.\n\n## Common Incoming Relationships\n\n- `carried_out_by` from activities.\n- `current_owner`, `current_custodian`, and `current_permanent_custodian` from object records.\n- `represents` from visual works.\n- `about` from textual works.\n- `transferred_custody_to` and `transferred_custody_from` from provenance activities.\n- `transferred_title_to` and `transferred_title_from` from provenance activities.\n- `paid_to` and `paid_from` from provenance payment activities.\n\n## Meta Museum Notes\n\nMeta Museum already exposes people through `/api/agents/{id}` and preserves rich `Person` records through `/api/records/{id}`. Existing actor tests cover name parts, authority `equivalent[]`, group membership, `contact_point`, residence places, `born`, `died`, professional `carried_out` activity, burial or other `participated_in` activity, biography statements, and typed nationality/gender/occupation classifications.\n\n## Test Ideas\n\n- Keep `/api/agents/{id}` role coverage aligned with both `Person` and `Group`.\n- Preserve a `Person` fixture with `born`, `died`, `contact_point`, `residence`, `carried_out`, `participated_in`, `member_of`, `equivalent`, and typed classifications.\n- Preserve incoming provenance references to people for title transfer, custody transfer, and payment without flattening them into labels.\n- Ensure gender, nationality, and occupation stay `classified_as` terms rather than custom person subclasses.\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 Fields","anchor":"optional-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-people\">Linked Art API: People</h1>\n<p><strong>Last refreshed:</strong> 2026-07-06</p>\n<p>Source: <a href=\"https://linked.art/api/1.0/endpoint/person/\" target=\"_blank\" rel=\"noopener noreferrer\" class=\"doc-link\">People 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 Person endpoint describes people, living or dead. This includes artists, collectors, curators, conservators, museum staff, and other people who perform professional or historical activities on or using works of art.</p>\n<p>The endpoint is similar to the Group endpoint, but person lifecycle events use `Birth` and `Death`.</p>\n<h2 id=\"required-shape\">Required Shape</h2>\n<p>A Person 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 person.</li><li>`type`: `Person`.</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, such as gender, nationality, or occupation terms.</li><li>`identified_by`: `Name` and/or `Identifier` structures.</li></ul>\n<h2 id=\"optional-fields\">Optional Fields</h2>\n<ul><li>`referred_to_by`: statements about the person, such as biography statements.</li><li>`equivalent`: external identities.</li><li>`representation`: visual works representing the person.</li><li>`member_of`: group membership.</li><li>`subject_of`: textual works focused on the person.</li><li>`attributed_by`: relationship assignment evidence.</li><li>`contact_point`: addresses or contact identifiers.</li><li>`residence`: associated place.</li><li>`carried_out`: professional activities of the person.</li><li>`participated_in`: events or activities in which the person participated but was not responsible.</li><li>`born`: `Birth` event for the person.</li><li>`died`: `Death` event for the person.</li></ul>\n<h2 id=\"common-incoming-relationships\">Common Incoming Relationships</h2>\n<ul><li>`carried_out_by` from activities.</li><li>`current_owner`, `current_custodian`, and `current_permanent_custodian` from object records.</li><li>`represents` from visual works.</li><li>`about` from textual works.</li><li>`transferred_custody_to` and `transferred_custody_from` from provenance activities.</li><li>`transferred_title_to` and `transferred_title_from` from provenance activities.</li><li>`paid_to` and `paid_from` from provenance payment activities.</li></ul>\n<h2 id=\"meta-museum-notes\">Meta Museum Notes</h2>\n<p>Meta Museum already exposes people through `/api/agents/{id}` and preserves rich `Person` records through `/api/records/{id}`. Existing actor tests cover name parts, authority `equivalent[]`, group membership, `contact_point`, residence places, `born`, `died`, professional `carried_out` activity, burial or other `participated_in` activity, biography statements, and typed nationality/gender/occupation classifications.</p>\n<h2 id=\"test-ideas\">Test Ideas</h2>\n<ul><li>Keep `/api/agents/{id}` role coverage aligned with both `Person` and `Group`.</li><li>Preserve a `Person` fixture with `born`, `died`, `contact_point`, `residence`, `carried_out`, `participated_in`, `member_of`, `equivalent`, and typed classifications.</li><li>Preserve incoming provenance references to people for title transfer, custody transfer, and payment without flattening them into labels.</li><li>Ensure gender, nationality, and occupation stay `classified_as` terms rather than custom person subclasses.</li></ul>","updatedAt":"2026-07-06T00:00:00.000Z","checksum":"00141f499e001dbebf6ccfc1b3ae2482fc0b874a25c7215d4a51115e3cf8c94d","checksumPrefix":"00141f499e00","anchorCount":7,"lineCount":62,"rawUrl":"/api/docs/content?path=linked-art%2Fapi%2Fpeople.md","htmlUrl":"/docs?doc=linked-art%2Fapi%2Fpeople.md","apiUrl":"/api/docs/content?path=linked-art%2Fapi%2Fpeople.md"}