Please note, we are in the process of retiring the public api. The public api, as well as its documentation and playground, will remain available until July 28th, 2025. This change will not affect integration partners using our partner api.


If you're an Artsy partner gallery, reach out to your Artsy Liaison or contact our Support team for assistance.

Public API 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: 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: the server responded with status 404

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": "2019-03-13T01:02:07+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": true,
  "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": "https://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"
    }
  }
}