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 "https://api.artsy.net/api/shows/{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

Key Description
id Unique id.
created_at Timestamp of when the record was created.
updated_at Timestamp of when the record was last updated.
name The name of the show.
sortable_name The sortable name of the show for correct alphabetical sorting.
description Show description.
press_release Show press release.
start_at When the show starts.
end_at When the show ends.
status Show status, one of upcoming, running or closed.
is_reference Whether the show is a reference on an artist CV. Not intended to be used for a browsing experience.
is_solo_show Does the show primarily feature the work of one artist.
is_group_show Does the show feature the work of multiple artists.
is_institutional_show Does the show take place inside an institutional partner.
is_fair_booth Is the show a partner's booth at a fair.
image_versions Available image versions.

Links

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

Example

{
  "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": [
    "featured",
    "general",
    "large",
    "larger",
    "medium",
    "square",
    "tall"
  ],
  "_links": {
    "thumbnail": {
      "href": "https://d32dm0rphc51dk.cloudfront.net/Bzp0BLipfnPU1hd6DHyHJw/medium.jpg"
    },
    "image": {
      "href": "https://d32dm0rphc51dk.cloudfront.net/Bzp0BLipfnPU1hd6DHyHJw/{image_version}.jpg",
      "templated": true
    },
    "self": {
      "href": "https://api.artsy.net/api/shows/4ea19ee97bab1a0001001908"
    },
    "permalink": {
      "href": "http://www.artsy.net/show/paradise-row-avenue-des-gobelins"
    },
    "partner": {
      "href": "https://api.artsy.net/api/partners/4df2262be7432d000100ba86"
    },
    "artworks": {
      "href": "https://api.artsy.net/api/artworks?show_id=4ea19ee97bab1a0001001908"
    },
    "images": {
      "href": "https://api.artsy.net/api/images?show_id=4ea19ee97bab1a0001001908"
    }
  }
}