skkg_search_provenance
skkg_search_provenanceSearch provenance chains and SKKG acquisitions to list objects matching filters such as owner, place, date, price, or acquisition type.
Instructions
Search provenance chains and SKKG's acquisitions; lists the objects that match. Two layers: chain, the periods before SKKG that curators recorded for only a few hundred objects, and acquisition, how SKKG itself acquired about 55,000 objects (type, seller, date, price). By default both are searched; filters that belong to one layer (owner_type, certainty, holding_kind, transaction_type, source_type, owner, transaction_kind, place: chain; acquisition_type, acquired_from: acquisition) restrict the search to it. An entry matches when it meets every filter; each object lists its matching periods (matched_periods) and acquisition (matched_acquisition). Prices are compared in the currency recorded, never converted, so a price filter needs currency. Owner names are as SKKG publishes them; its anonymisation ("Unbekannte:r Eigentümer:in", "Privatperson") stays as it is: never try to identify those persons. Each object carries image_license (its primary image) and object_copyright: quote both. For the whole chain of one object, use skkg_get_object with include ["provenance", "acquisition"]; for a period, skkg_get_record with its id; for labels of the term filters, skkg_find_terms.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "skkg_search_provenance"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lang | No | Language of vocabulary labels. Most vocabularies, materials and object types among them, have German labels only, which are returned whatever the language; titles and texts stay as recorded | de |
| sort | No | date_asc (default: earliest matching entry first, a period open at its start before all others), date_desc (latest first, a period open at its end before all others), price_desc (highest price first; needs `currency`), or inventory_number | date_asc |
| layer | No | chain (periods before SKKG), acquisition (SKKG's own acquisitions), or both (default) | both |
| limit | No | Objects per page. Default 5 | |
| owner | No | Owner of a chain period: an actor id ("person/…") or a name ("Stuker", "Galerie Kornfeld"). A name matches every person or institution whose name contains all its words; applied_filters lists them | |
| place | No | Place of a chain period, as SKKG writes it ("Zürich", "Genf", "Paris"). Each word matches the start of a word, ignoring case and accents; applied_filters lists the places matched | |
| offset | No | ||
| year_to | No | Latest year; see year_from | |
| currency | No | Currency of the price: its ISO code or SKKG's label of it, e.g. "CHF", "DEM", "GBP", "DM" (SKKG's "DM" and "FF" are DEM and FRF). Alone, it keeps the entries with a price in that currency | |
| certainty | No | Certainty of a period: "gesichert", "wahrscheinlich", "vermutlich", or "möglicherweise". A term id ("type/…") or a German label, matched exactly except for case. | |
| price_max | No | Highest price, in `currency`; see price_min | |
| price_min | No | Lowest price, in `currency`, which it needs. A batch price (is_batch_price) is the price of all objects of the batch | |
| year_from | No | Earliest year. A chain period matches when its dates overlap the range, an acquisition when its year is in it; undated entries never match. A period open at one end ("seit 1995", "1916–o. D.", "bis 1934") reaches every year on that side; a lone date with another qualifier ("um 1900", "vor 1997", "spätestens 1907") is that year only | |
| owner_type | No | Kind of owner, e.g. "Privatbesitzer:in", "Auktionshaus", "Galerie". A term id ("type/…") or a German label, matched exactly except for case. | |
| source_type | No | Type of a period's source, e.g. "Archivquelle (SKKG)", "Archivquelle (extern)", "Kommentar (Fussnote)". A term id ("type/…") or a German label, matched exactly except for case. | |
| holding_kind | No | Kind of holding, e.g. "Eigentum", "Besitz", "Kommissionsware". A term id ("type/…") or a German label, matched exactly except for case. | |
| acquired_from | No | Who SKKG acquired the object from: an actor id or a name, as for `owner` | |
| acquisition_type | No | How SKKG acquired the object, e.g. "Auktion", "Freihandkauf", "Schenkung". A term id ("type/…") or a German label, matched exactly except for case. | |
| transaction_kind | No | acquisition: the owner received title; custody: the owner received custody only, as with goods on commission or in storage; activity: SKKG records no transfer for the period | |
| transaction_type | No | How the owner got the object, e.g. "erworben auf Auktion", "geerbt", "erworben als Kauf". A term id ("type/…") or a German label, matched exactly except for case. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | Yes | ||
| total | Yes | Objects with a matching entry | |
| layers | Yes | The layers searched, after the filters that belong to one layer | |
| offset | Yes | ||
| results | Yes | ||
| has_more | Yes | ||
| returned | Yes | ||
| warnings | No | ||
| data_as_of | No | ||
| next_offset | No | ||
| total_periods | Yes | Chain periods that matched, each once, including those in unlinked_periods | |
| applied_filters | No | ||
| unlinked_periods | No | Matching periods that belong to no object in the database; skkg_get_record returns each by its id | |
| total_acquisitions | Yes | SKKG acquisitions that matched, over all objects |