Search exhibitions
artic_search_exhibitionsSearch Art Institute of Chicago exhibitions by text, date, artwork_id, or artist_id. Relationship filters cover recorded museum links; an absent link does not prove an artwork or artist never appeared in a show. For the full exhibition record of one artwork, read the exhibition_history section of artic_get_artworks. Results carry dates, gallery, summary, web page, and listed artworks. Pass artwork ids to artic_get_artworks for full records.
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": "artic_search_exhibitions"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page to return (1-based); page times the applied limit may not exceed 1,000. | |
| sort | No | relevance ranks by query text; start_desc and start_asc sort by opening date. Defaults to relevance with a query, else start_desc; relevance without a query sorts as start_desc. | |
| when | No | current: open today; upcoming: opens after today; past: closed before today; any: no date condition. A show with no recorded closing date is past when marked Closed, else current from its opening. | any |
| limit | No | Requested exhibitions per page (1-1,000); at most 100 are returned. | |
| query | No | Text matched against exhibition titles, descriptions, and other fields; every word must match, except common English words such as the and of, which are ignored. | |
| date_to | No | Latest date, YYYY-MM-DD; an exhibition matches when its run overlaps date_from to date_to. Missing dates are read as described for date_from. | |
| artist_id | No | Exact museum agent id, from artic_search_artists or an artwork artist_id; matches recorded exhibition relationships. Combined with every other condition using AND. | |
| date_from | No | Earliest date, YYYY-MM-DD; an exhibition matches when its run overlaps date_from to date_to. A show with no recorded closing date ran on its opening date alone when marked Closed, else runs on from its opening; one with only a closing date ran on that date alone; one with no dates matches no window. | |
| artwork_id | No | Exact museum artwork id, from artic_search_artworks or artic_get_artworks; matches recorded exhibition relationships. Combined with every other condition using AND. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cap | No | The limit applied to this page. | |
| page | No | Page returned (1-based). | |
| error | No | Present when the call failed. Absent on success. | |
| shown | No | Exhibitions returned on this page. | |
| notice | No | Guidance when nothing matched, more pages exist, or the reachable window is exhausted. | |
| has_more | No | True when more matches exist beyond this page. | |
| next_page | No | Page to request next; absent when nothing remains or the next page would pass the first 1,000 matches. | |
| truncated | No | True when more matches exist beyond this page. | |
| totalCount | No | Matches for the query and filters, before paging. | |
| exhibitions | No | Matching exhibitions on this page, in ranked or sorted order. | |
| license_text | No | License statement from the API for this data, verbatim. | |
| sort_applied | No | Order applied. | |
| when_applied | No | The when condition applied. |