Get an artwork as Linked Art
Returns the artwork as a Linked Art JSON-LD document (`application/ld+json`): its names, type of work as a Getty AAT concept, production with dates and artists, dimensions, medium, and provenance as acquisitions. The document holds only what the caller may read elsewhere. An artist's ULAN and Wikidata ids appear for a member, and for a key with `contacts:read` while the party is an eligible artist. Provenance names a party only for a caller with `contacts:read`; a key that reads no entries gets the published work's public wording. No party id ever appears.
Returns the artwork as a Linked Art JSON-LD document (application/ld+json): its names, type of work as a Getty AAT concept, production with dates and artists, dimensions, medium, and provenance as acquisitions. The document holds only what the caller may read elsewhere. An artist's ULAN and Wikidata ids appear for a member, and for a key with contacts:read while the party is an eligible artist. Provenance names a party only for a caller with contacts:read; a key that reads no entries gets the published work's public wording. No party id ever appears.
Authorization
bearerAuth artworks:read, artists:readA gallery API key, sent as Authorization: Bearer gpk_… (or the x-api-key header).
In: header
Scope: artworks:read, artists:read
Path Parameters
The artwork id.
Response Body
application/ld+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
{ "@context": "https://linked.art/ns/v1/linked-art.json", "id": "string", "type": "HumanMadeObject", "_label": "string", "property1": null, "property2": null}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "invalid_request", "retry": "permanent", "details": null}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "invalid_request", "retry": "permanent", "details": null}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "invalid_request", "retry": "permanent", "details": null}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "invalid_request", "retry": "permanent", "details": null}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "invalid_request", "retry": "permanent", "details": null}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "invalid_request", "retry": "permanent", "details": null}List artwork interests GET
Lists the open interests in an artwork from every source, newest first: stated by a member, recorded from notes, observed from engagement (favourites, waitlist, inquiries) and inferred by the match engine. Each row names its `source`; filter with `source` (stated, observed, inferred, recorded; comma-separated). Requires `contacts:read` beside `artworks:read`, since an interest reveals a collector.
List artworks GET
Lists the gallery's artworks, newest first, with cursor pagination. Pass `draft=true` to get the editor's working copy (pending edits overlaid) instead of the published state. Pass `ids` (comma-separated, max 50) to fetch an explicit set.