Public API Documentation > Resources > Images
Retrieve collections of images following the "images" link from shows.
curl -v "https://api.artsy.net/api/images?show_id={show_id}" -H "X-XAPP-Token: XAPP_TOKEN"
This endpoint accepts the following parameters.
| Name | Value |
|---|---|
| show_id | Retrieve images for a given show, often called "installation shots". |
Images are usually related to other objects, such as profiles.
curl -v "https://api.artsy.net/api/images/{id}" -H "X-XAPP-Token: XAPP_TOKEN"
error: the server responded with status 404
| Key | Target |
|---|---|
| self | The image resource. |
{
"id": "54bfdb597261692b57fd0000",
"created_at": "2015-01-21T17:01:13+00:00",
"updated_at": "2015-01-21T17:01:13+00:00",
"position": 1,
"default": false,
"aspect_ratio": null,
"original_height": null,
"original_width": null,
"image_versions": [
"medium250x165",
"wide"
],
"_links": {
"thumbnail": {
"href": "https://d32dm0rphc51dk.cloudfront.net/-AzVJo2GfeQceXVceoqHKA/medium250x165.jpg"
},
"image": {
"href": "https://d32dm0rphc51dk.cloudfront.net/-AzVJo2GfeQceXVceoqHKA/{image_version}.jpg",
"templated": true
},
"self": {
"href": "https://api.artsy.net/api/images/54bfdb597261692b57fd0000"
}
}
}