Documentation > Resources > Shows

Shows API

A show is a display of artworks by one or several artists, produced by an Artsy partner.

Retrieving Shows

Retrieve shows by following the shows link from root, or the "shows" links within a partner.

curl -v "{id}" -H "X-XAPP-Token:..."

This endpoint accepts the following parameters.

Name Value
partner_id Retrieve shows for a given partner.
status Retrieve shows with a specific status (see below).
fair_id Retrieve shows for a given fair.

Show Status

Status Description
upcoming Opening in the future.
running Currently running.
closed Closed.
current Running or upcoming.

Show JSON Format

error: missing models


Key Target
self The show resource.
thumbnail Default image thumbnail.
image Curied image location.
permalink An external location on the website.
partner Show partner.
artworks Show artworks.


  "id": "4ea19ee97bab1a0001001908",
  "created_at": "2011-10-21T16:33:45+00:00",
  "updated_at": "2017-05-09T21:18:21+00:00",
  "name": "Avenue des Gobelins",
  "sortable_name": "avenue des gobelins",
  "description": "Borrowing its title from one of Eugene Atgetā€™s iconic photographs of Parisian shop fronts, Avenue des Gobelins is a meditation on the mystical, ritual nature of material desire and consumption. The central work of this exhibition is a slide-loop projection, The Consumystic. By double and triple-exposing the film, Gluzberg adopts the analogue photographic techniques of the Surrealists to produce a mesh of consumer signs and spaces: the black gleaming lacquer of Chanel, reconfigured by the chaos of a Saturday afternoon at Primark.",
  "press_release": "",
  "start_at": "2011-11-16T00:00:00+00:00",
  "end_at": "2011-12-21T00:00:00+00:00",
  "status": "closed",
  "is_reference": false,
  "is_solo_show": true,
  "is_group_show": false,
  "is_institutional_show": false,
  "is_fair_booth": false,
  "image_versions": [
  "_links": {
    "thumbnail": {
      "href": ""
    "image": {
      "href": "{image_version}.jpg",
      "templated": true
    "self": {
      "href": ""
    "permalink": {
      "href": ""
    "partner": {
      "href": ""
    "artworks": {
      "href": ""
    "images": {
      "href": ""