List a party's interests
Lists a party's open interests in artworks, artists and tags, newest first. Filter with `source` (stated, observed, inferred, recorded; comma-separated). Requires `artworks:read` beside `contacts:read`, since the targets are catalogue objects.
Lists a party's open interests in artworks, artists and tags, newest first. Filter with source (stated, observed, inferred, recorded; comma-separated). Requires artworks:read beside contacts:read, since the targets are catalogue objects.
Authorization
bearerAuth contacts:read, artworks:readA gallery API key, sent as Authorization: Bearer gpk_… (or the x-api-key header).
In: header
Scope: contacts:read, artworks:read
Path Parameters
The party id.
Query Parameters
Only these sources (stated, observed, inferred, recorded), comma-separated.
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", "party_id": "string", "target": { "type": "artwork", "id": "string" }, "source": "stated", "strength": 0, "level": "inquiry", "note": "string", "actor_id": "string", "valid_from": "string", "valid_to": "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}Get a party GET
Returns one party. A merged-away id returns the party it merged into.
List parties GET
Lists the gallery's parties, newest first, with cursor pagination. Parties hidden from the Contacts list (artist-only, member and gallery parties) are left out unless `listed=all`. Archived parties are left out unless `archived=true`. Pass `ids` (comma-separated, max 50) to fetch an explicit set.