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.
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.
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",
  "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",
  "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"
    }
  }
}