List artwork price history
Lists an artwork's price changes, newest first. Appended automatically whenever the price changes.
Lists an artwork's price changes, newest first. Appended automatically whenever the price changes.
Authorization
bearerAuth artworks:read, artworks.financial:readA gallery API key, sent as Authorization: Bearer gpk_… (or the x-api-key header).
In: header
Scope: artworks:read, artworks.financial:read
Path Parameters
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", "price_cents": -9007199254740991, "currency": "string", "label": "string", "changed_by": "string", "created_at": "string" } ]}{ "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}Set an artwork's price POST
Sets the artwork's list price on the record now — live for every reader, whoever sends it — and appends the price history. A pending draft that named the price is reconciled and the editor is told. Use this, not `PATCH`, to change a price.
Record a provenance entry POST
Adds one entry to the artwork's provenance at `position` (from 1), moving later entries down one, or last without a position. Name each end by a party of this gallery or by wording such as “Private collection, Paris”; an entry needs at least one. A key needs `contacts:read` to name a party, or to land the entry ahead of one that names a party, else 403 with `details.reason` `contacts_read_required`. `public` visibility shows the entry's labels, never a party, on the published work.