Gallery Platform API
Reference

List an artwork's provenance

Lists the artwork's provenance entries in chain order, earliest first: who the work moved from and to (a party or wording), how, where, when and on what evidence. Entries name parties, so a key needs an artworks write scope or `contacts:read`; an `artworks:read`-only key gets 403. A published work's public wording reaches any key at `GET /gallery/artworks/{id}/provenance/public`.

GET
/gallery/artworks/{id}/provenance

Lists the artwork's provenance entries in chain order, earliest first: who the work moved from and to (a party or wording), how, where, when and on what evidence. Entries name parties, so a key needs an artworks write scope or contacts:read; an artworks:read-only key gets 403. A published work's public wording reaches any key at GET /gallery/artworks/{id}/provenance/public.

Authorization

AuthorizationBearer <token>

A gallery API key, sent as Authorization: Bearer gpk_… (or the x-api-key header).

In: header

Scope: artworks:read, artworks:create

Path Parameters

id*string

The artwork id.

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

{  "data": [    {      "id": "string",      "artwork_id": "string",      "position": -9007199254740991,      "kind": "sale",      "from_party_id": "string",      "to_party_id": "string",      "from_label": "string",      "to_label": "string",      "place": "string",      "starts_on": "string",      "ends_on": "string",      "date_precision": "year",      "uncertain": true,      "sale_id": "string",      "ownership_id": "string",      "source": "string",      "document_id": "string",      "visibility": "member",      "note": "string",      "created_at": "string",      "updated_at": "string"    }  ]}