Gallery Platform API
Reference

List the contacts matched to an artwork

Returns the contacts the recommendation engine matched to this work, best first, each with a calibrated probability, per-question sub-scores, and the evidence items behind it. Only pairs at or above the visible floor are returned unless `min_probability` lowers it; pairs a member hid are omitted unless `include_hidden` is set. Empty until the engine has judged the work.

GET
/gallery/artworks/{id}/matches

Returns the contacts the recommendation engine matched to this work, best first, each with a calibrated probability, per-question sub-scores, and the evidence items behind it. Only pairs at or above the visible floor are returned unless min_probability lowers it; pairs a member hid are omitted unless include_hidden is set. Empty until the engine has judged the work.

Authorization

bearerAuth artworks:read, contacts:read
AuthorizationBearer <token>

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

In: header

Scope: artworks:read, contacts:read

Path Parameters

id*string

The artwork id.

Query Parameters

limit?integer

Page size. Defaults to 20; the maximum is 100.

Range1 <= value <= 100
Default20
cursor?string

Opaque cursor from the previous page's next_cursor. Omit for the first page.

min_probability?number

Lowest probability to include, 0–1. Defaults to the visible floor (0.6).

Range0 <= value <= 1
include_hidden?string

When true, also returns pairs a member hid through feedback.

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",      "contact_id": "string",      "probability": 0,      "sub_scores": {        "property1": 0,        "property2": 0      },      "reasons": [        {          "question": "medium",          "kind": "memory_fact",          "evidence_id": "string",          "label": "string",          "source_label": "string",          "at": "string"        }      ],      "evidence_count": -9007199254740991,      "status": "active",      "hidden_until": "string",      "judged_at": "string",      "model": "string",      "counterpart_name": "string"    }  ],  "next_cursor": "string"}

List artwork location history GET

Lists an artwork's location / movement history, newest first. Appended automatically whenever the artwork's location changes.

Parse a caption into an artwork draft POST

Parses a pasted free-text caption into a structured artwork DRAFT for review — artist (resolved detect-existing-or-create against the gallery's roster), title, year, medium, dimensions, price/currency (incl. a range), and edition, with low-confidence fields flagged. This is read-shaped: it returns a suggestion and writes nothing. The model loop is server-only (the Anthropic key never reaches the browser); requires a first-party session.