Public API Documentation > Resources > Images

Images API

Retrieving Images

Retrieve collections of images following the "images" link from shows.

curl -v "{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".

Retrieving an Image

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

curl -v "{id}" -H "X-XAPP-Token: XAPP_TOKEN"

Image JSON Format

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": [
  "_links": {
    "thumbnail": {
      "href": ""
    "image": {
      "href": "{image_version}.jpg",
      "templated": true
    "self": {
      "href": ""