Documentation > Resources > Images

Images API

Retrieving 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:..."

This endpoint accepts the following parameters.

Name Value
show_id Retrieve images for a given show, often called "installation shots".

Retrieving an Image

Images are usually related to other objects, such as profiles.

curl -v "https://api.artsy.net/api/images/{id}" -H "X-XAPP-Token:..."

Image 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.
position Image position within a collection.
default True if the image is the default one in a collection.
aspect_ratio Image aspect ratio.
original_height Original height of image.
original_width Original width of image.
image_versions Available image versions.

Links

Key Target
self The image resource.

Example

{
  "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"
    }
  }
}