List parties
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.
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.
Authorization
bearerAuth contacts:readA gallery API key, sent as Authorization: Bearer gpk_… (or the x-api-key header).
In: header
Scope: contacts:read
Query Parameters
Page size. Defaults to 20; the maximum is 100.
1 <= value <= 10020Opaque cursor from the previous page's next_cursor. Omit for the first page.
Comma-separated ids to fetch as an explicit set (maximum 50).
1 <= items <= 50Free-text search over the resource's searchable fields.
length <= 200Filter to the given kind; the schema's enum lists the values.
1 <= itemsFilter to the given contact types (comma-separated).
1 <= itemsParties holding an open role in this comma-separated set (collector, consignor, lender, …).
Filter to the given lead status.
1 <= itemsFilter to the given tag id.
1 <= items <= 10true: only archived parties; absent or false: live parties only.
all includes the parties hidden from the Contacts list (artist-only, member and gallery parties).
Sort by one of: name, created, updated (default created).
Value in
- "name"
- "created"
- "updated"
Sort direction (default desc).
Value in
- "asc"
- "desc"
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", "name": "string", "kind": "person", "contact_type": "collector", "company": "string", "city": "string", "email": "string", "phone": "string", "notes": "string", "lead_status": "new", "form_of_address": "string", "locale": "string", "do_not_email": true, "do_not_sms": true, "acquisition_source": "inquiry", "acquired_at": "string", "archived_at": "string", "ulan": "string", "wikidata": "string", "isni": "string", "viaf": "string", "lei": "string", "assignee_ids": [ "string" ], "collector_profile": { "collecting_focus": "string", "budget_band": "string", "wishlist_notes": "string", "preferred_contact_method": "string", "vip": true, "tax_exempt": true, "created_at": "string", "updated_at": "string" }, "institution_profile": { "institution_kind": "string", "tax_exempt": true, "acquisition_process": "string", "primary_contact_name": "string", "created_at": "string", "updated_at": "string" }, "last_interaction_at": "string", "last_interaction_type": "note", "roles": [ { "role": "collector", "valid_from": "string" } ], "custom_fields": { "property1": null, "property2": null }, "save_state": "new", "metadata": { "property1": "string", "property2": "string" }, "created_at": "string", "updated_at": "string" } ], "next_cursor": "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}List a party's interests GET
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.
Merge a party POST
Merges the party `merged_id` into this one, moving everything that points at it (interactions, tasks, notes, pipeline entries, ownership, roles, accounts, and the rest), then deleting it. The merged id keeps reading as this party. Refused with 409 when both parties belong to gallery members, both have a collector account, both have a Stripe customer, or either is the gallery's own party. Confirmation-gated: pass `confirm: true`. Cannot be undone.