Public API Documentation > Resources > Shows
A show is a display of artworks by one or several artists, produced by an Artsy partner.
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. |
| Status | Description |
|---|---|
| upcoming | Opening in the future. |
| running | Currently running. |
| closed | Closed. |
| current | Running or upcoming. |
error: the server responded with status 404
| 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. |
{
"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"
}
}
}