API Reference - Event

Event

Available resources on the Event API endpoints.

Genres

A list of all valid event genres.

Event Genres
GET/event/genres?parent_key={parent_key}&parent_genres_only={parent_genres_only}

Example URI

GET https://api.ents24.com/event/genres?parent_key=music&parent_genres_only=1
URI Parameters
HideShow
parent_key
string (optional) Example: music

The parent of genre you want a list of genres for. E.G: music, comedy or theatre-shows.

parent_genres_only
boolean (optional) Example: 1

Decides whether or not subgenres are included in the genre list. NB: This parameter is disregarded if the parent_key parameter is set in the same request.

Request
HideShow
Headers
Authorization: qnFqFAVw8pJMCF1z8tIMYoXwommArRmt9C08jIRA
Response  200
HideShow
Headers
Content-Type: application/json
Date: Tue, 26 Aug 2014 08:00:00 GMT
Expires: Tue, 26 Aug 2014 09:00:00 GMT
Last-Modified: Tue, 25 Aug 2014 22:10:00 GMT
Body
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "title": "Event Genres",
  "description": "A list of valid event genres",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "key": {
        "description": "The genre key. This is the value used in an Event object's `genre` property",
        "type": "string"
      },
      "title": {
        "description": "The genre title",
        "type": [
          "string",
          "null"
        ]
      },
      "isSubGenre": {
        "description": "Flag showing if this genre object has a parent genre object",
        "type": "boolean"
      },
      "parentKey": {
        "description": "The key of the parent genre. E.G: Music, Comedy or Theatre",
        "type": "string"
      }
    }
  }
}

List

Multiple event objects with selected fields.
NB: You must filter resources retrieved from this end-point with at least one of the following request parameters:
location venue_name artist_name

Event List
GET/event/list?name={name}&location={location}&radius_distance={radius_distance}&distance_unit={distance_unit}&genre={genre}&date={date}&date_from={date_from}&date_to={date_to}&venue_name={venue_name}&venue_postcode={venue_postcode}&artist_name={artist_name}&results_per_page={results_per_page}&page={page}&incl_image={incl_image}&image_size={image_size}&incl_stages={incl_stages}&incl_artists={incl_artists}&incl_occurrences={incl_occurrences}&incl_tickets={incl_tickets}&full_description={full_description}&updated_since={updated_since}&created_since={created_since}&order_by={order_by}&order_direction={order_direction}

Example URI

GET https://api.ents24.com/event/list?name=Bristol Jazz Show&location=postcode:SW1X 7LY&radius_distance=10&distance_unit=mi&genre=rock&date=2014-09-03&date_from=2014-09-03&date_to=2014-09-10&venue_name=Hyde Park&venue_postcode=SW1X 7LY&artist_name=Blondie&results_per_page=25&page=ZW0=&incl_image=1&image_size=medium&incl_stages=1&incl_artists=1&incl_occurrences=1&incl_tickets=1&full_description=0&updated_since=2015-08-15T15:52:01+00:00&created_since=2015-08-15T15:52:01+00:00&order_by=lastUpdate&order_direction=desc
URI Parameters
HideShow
name
string (optional) Example: Bristol Jazz Show

Search term for the name of the events to be listed.

location
string (optional) Example: postcode:SW1X 7LY

The location of events you want a listing for. Values should be prefixed with the type of location data you are submitting [name:, postcode:, geo:]. NB: Values applied to this parameter with the name may be ambiguous E.G: Newcastle. Use location/search endpoint to find a unique location identifier (postcode or lat,lng) that matches the location you want.

radius_distance
integer (optional) Example: 10

The furthest distance from the location you want events listed for. NB: The location parameter is required when this parameter is set.

distance_unit
string (optional) Example: mi

The unit of measurment that should be applied to the radius distance value [mi, km]. NB: The location parameter is required when this parameter is set.

genre
string (optional) Example: rock

The genre of event type you want listed.

date
date (optional) Example: 2014-09-03

A specific date you want an events listing for. NB: This parameter is disregarded if date from and date to parameters are set in the same request.

date_from
date (optional) Example: 2014-09-03

The date you want an events listing from. NB: This parameter is required when the date to parameter is set.

date_to
date (optional) Example: 2014-09-10

The date you want an events listing to. NB: This parameter is required when date from parameter is set.

venue_name
string (optional) Example: Hyde Park

Search term for the name of the venue you want an events listing for. NB: Values applied to this parameter may match more than one venue! You should use the venue/events end-point to get event listings for a particular venue.

venue_postcode
string (optional) Example: SW1X 7LY

The postcode of the venue you want an events listing for. NB: This parameter will only produce a list of events for venues with the exact postcode given. Values applied to this parameter may match more than one venue! You should use the venue/events end-point to get event listings for a particular venue.

artist_name
string (optional) Example: Blondie

Search term for the name of the artist you want an events listing for. NB: Values applied to this parameter may match more than one artist! You should use the artist/events end-point to get an upcoming events list for a particular artist.

incl_image
boolean (optional) Example: 1

Decides whether or not an event image is included in the response.

image_size
string (optional) Example: medium

Chooses the size of image included with each image object if one is available [small, medium, large].

incl_stages
boolean (optional) Example: 1

Decides whether or not a list of stages is included for any festival events in the response.

incl_artists
boolean (optional) Example: 1

Decides whether or not a list of performing artists is included in the response.

incl_occurrences
boolean (optional) Example: 1

Decides whether or not a list of individual event occurrences is included for any repeat events in the response.

incl_tickets
boolean (optional) Example: 1

Decides whether or not a list of available tickets is included in the response.

full_description
boolean (optional) Example: 0

Decides whether full or summarised description text is included in the response.

updated_since
datetime (optional) Example: 2015-08-15T15:52:01+00:00

Only retrieve events that have been added/updated since the given timestamp (RFC3339).

created_since
datetime (optional) Example: 2015-08-15T15:52:01+00:00

Only retrieve events that have been added since the given timestamp (RFC3339).

results_per_page
integer (optional) Example: 25

The number of results you want per page/chunk [5, 10, 25, 50, 75, 100].

page
string (optional) Example: ZW0=

The page/chunk of results to be requested.

order_by
string (optional) Example: lastUpdate

Order events by the named object property.

order_direction
string (optional) Example: desc

Ordering direction [asc, desc].

Request
HideShow
Headers
Authorization: qnFqFAVw8pJMCF1z8tIMYoXwommArRmt9C08jIRA
Response  200
HideShow
Headers
Content-Type: application/json
Date: Tue, 26 Aug 2014 08:00:00 GMT
Expires: Tue, 26 Aug 2014 09:00:00 GMT
Last-Modified: Tue, 25 Aug 2014 22:10:00 GMT
X-Next-Page: R2U=
X-Previous-Page: bUw=
X-Total-Items-Found: 75
Body
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "title": "Event List",
  "description": "A list of Event objects with selected fields",
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "id": {
        "description": "Unique identifier for the event",
        "type": "string"
      },
      "title": {
        "description": "Title of the event",
        "type": [
          "string",
          "null"
        ]
      },
      "headline": {
        "description": "Headline of the event",
        "type": [
          "string",
          "null"
        ]
      },
      "startDate": {
        "description": "RFC-3339 formatted start date for the event",
        "type": "string"
      },
      "endDate": {
        "description": "RFC-3339 formatted end date for the event",
        "type": "string"
      },
      "startTimeString": {
        "description": "Start time string for the event",
        "type": [
          "string",
          "null"
        ]
      },
      "endTimeString": {
        "description": "End time string for the event",
        "type": [
          "string",
          "null"
        ]
      },
      "hasMoved": {
        "description": "Flag to indicate if an event has been moved to another location",
        "type": "boolean"
      },
      "isCancelled": {
        "description": "Flag to indicate if an event has been cancelled",
        "type": "boolean"
      },
      "isPostponed": {
        "description": "Flag to indicate if an event has been postponed",
        "type": "boolean"
      },
      "isRescheduled": {
        "description": "Flag to indicate if an event has been re-scheduled",
        "type": "boolean"
      },
      "isSoldOut": {
        "description": "Flag to indicate whether the event is sold out",
        "type": "boolean"
      },
      "ticketsAvailable": {
        "description": "Flag to indicate whether there are tickets available for the event",
        "type": "boolean"
      },
      "isFree": {
        "description": "Flag to indicate whether the event is free entry",
        "type": "boolean"
      },
      "price": {
        "description": "Price info for the event",
        "type": [
          "string",
          "null"
        ]
      },
      "venue": {
        "description": "Venue the event is being held at",
        "type": "object",
        "properties": {
          "id": {
            "description": "Unique identifier for the venue",
            "type": "string"
          },
          "name": {
            "description": "Name of the venue",
            "type": "string"
          },
          "town": {
            "description": "Town or city where the venue is located",
            "type": "string"
          },
          "location": {
            "description": "Lat/Lon coordinates of the venue",
            "$ref": "http://json-schema.org/geo"
          }
        }
      },
      "description": {
        "description": "Description text for the event",
        "type": [
          "string",
          "null"
        ]
      },
      "artists": {
        "description": "Featured artists",
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "id": {
              "description": "Unique identifier for a featured artist",
              "type": "string"
            },
            "name": {
              "description": "Name of a featured artist",
              "type": "string"
            }
          }
        }
      },
      "stages": {
        "description": "Stages at the event",
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "name": {
              "description": "Name of the stage",
              "type": "string"
            },
            "days": {
              "description": "Days or timespans performances are occuring on the stage",
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "id": {
                    "description": "Unique identifier for the stage day(s)",
                    "type": "string"
                  },
                  "startDate": {
                    "description": "The start date for this day or time-span",
                    "type": "string"
                  },
                  "endDate": {
                    "description": "The end date for this day or time-span",
                    "type": "string"
                  },
                  "artists": {
                    "description": "Performing artists",
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "description": "Unique identifier for a featured artist",
                          "type": "string"
                        },
                        "name": {
                          "description": "Name of a featured artist",
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      },
      "occurrences": {
        "description": "The individual occurences of a repeated event (E.G. A theatre show)",
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "id": {
              "description": "Unique identifier for the event",
              "type": "string"
            },
            "startDate": {
              "description": "RFC-3339 formatted start date for the event",
              "type": "string"
            },
            "endDate": {
              "description": "RFC-3339 formatted end date for the event",
              "type": "string"
            },
            "startTimeString": {
              "description": "Start time string for the event",
              "type": [
                "string",
                "null"
              ]
            },
            "endTimeString": {
              "description": "End time string for the event",
              "type": [
                "string",
                "null"
              ]
            },
            "hasMoved": {
              "description": "Flag to indicate if an event has been moved to another location",
              "type": "boolean"
            },
            "isCancelled": {
              "description": "Flag to indicate if an event has been cancelled",
              "type": "boolean"
            },
            "isPostponed": {
              "description": "Flag to indicate if an event has been postponed",
              "type": "boolean"
            },
            "isRescheduled": {
              "description": "Flag to indicate if an event has been re-scheduled",
              "type": "boolean"
            },
            "isSoldOut": {
              "description": "Flag to indicate whether the event is sold out",
              "type": "boolean"
            },
            "ticketsAvailable": {
              "description": "Flag to indicate whether there are tickets available for the event",
              "type": "boolean"
            },
            "isFree": {
              "description": "Flag to indicate whether the event is free entry",
              "type": "boolean"
            },
            "price": {
              "description": "Price info for the event",
              "type": [
                "string",
                "null"
              ]
            },
            "tickets": {
              "description": "Tickets for this event",
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "dateTime": {
                    "description": "RFC-3339 formatted date and time this ticket is valid for",
                    "type": "string"
                  },
                  "supplier": {
                    "description": "The supplier of this ticket",
                    "type": "string"
                  },
                  "price": {
                    "description": "The face-value price for this ticket",
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "totalPrice": {
                    "description": "The total price for this ticket",
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "inclBookingFee": {
                    "description": "Flag indicating whether a booking fee is included in the price of this ticket",
                    "type": "boolean"
                  },
                  "isOnSale": {
                    "description": "Flag indicating whether the ticket is on sale",
                    "type": "boolean"
                  },
                  "isAvailable": {
                    "description": "Flag indicating whether the ticket is available",
                    "type": "boolean"
                  },
                  "isPresaleTicket": {
                    "description": "Flag indicating whether the ticket is a pre-sale ticket",
                    "type": "boolean"
                  },
                  "isResaleTicket": {
                    "description": "Flag indicating whether the ticket is a re-sale ticket",
                    "type": "boolean"
                  },
                  "onSaleFrom": {
                    "description": "RFC-3339 formatted date this ticket goes on sale",
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "onSaleUntil": {
                    "description": "RFC-3339 formatted date this ticket is / will be on sale until",
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "url": {
                    "description": "The purchase URL for this ticket",
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "email": {
                    "description": "The sales email address for this ticket",
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "telephone": {
                    "description": "The sales phone line number for this ticket",
                    "type": [
                      "string",
                      "null"
                    ]
                  }
                }
              }
            }
          }
        }
      },
      "image": {
        "description": "Image asset for the event",
        "type": "object",
        "properties": {
          "url": {
            "description": "Image source URL",
            "type": "string"
          },
          "width": {
            "description": "Image width (px)",
            "type": "integer"
          },
          "height": {
            "description": "Image height (px)",
            "type": "integer"
          },
          "metadata": {
            "description": "Metadata related to this image",
            "type": "object",
            "properties": {
              "copyright": {
                "description": "The copyright holder for this image",
                "type": [
                  "string",
                  "null"
                ]
              },
              "caption": {
                "description": "Caption text for this image",
                "type": [
                  "string",
                  "null"
                ]
              }
            }
          }
        }
      },
      "tickets": {
        "description": "Tickets for this event",
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "dateTime": {
              "description": "RFC-3339 formatted date and time this ticket is valid for",
              "type": "string"
            },
            "supplier": {
              "description": "The supplier of this ticket",
              "type": "string"
            },
            "price": {
              "description": "The face-value price for this ticket",
              "type": [
                "string",
                "null"
              ]
            },
            "totalPrice": {
              "description": "The total price for this ticket",
              "type": [
                "string",
                "null"
              ]
            },
            "inclBookingFee": {
              "description": "Flag indicating whether a booking fee is included in the price of this ticket",
              "type": "boolean"
            },
            "isOnSale": {
              "description": "Flag indicating whether the ticket is on sale",
              "type": "boolean"
            },
            "isAvailable": {
              "description": "Flag indicating whether the ticket is available",
              "type": "boolean"
            },
            "isPresaleTicket": {
              "description": "Flag indicating whether the ticket is a pre-sale ticket",
              "type": "boolean"
            },
            "isResaleTicket": {
              "description": "Flag indicating whether the ticket is a re-sale ticket",
              "type": "boolean"
            },
            "onSaleFrom": {
              "description": "RFC-3339 formatted date this ticket goes on sale",
              "type": [
                "string",
                "null"
              ]
            },
            "onSaleUntil": {
              "description": "RFC-3339 formatted date this ticket is / will be on sale until",
              "type": [
                "string",
                "null"
              ]
            },
            "url": {
              "description": "The purchase URL for this ticket",
              "type": [
                "string",
                "null"
              ]
            },
            "email": {
              "description": "The sales email address for this ticket",
              "type": [
                "string",
                "null"
              ]
            },
            "telephone": {
              "description": "The sales phone line number for this ticket",
              "type": [
                "string",
                "null"
              ]
            }
          }
        }
      },
      "genre": {
        "description": "The genre(s) this event is found under",
        "type": "array",
        "items": {
          "type": "string"
        }
      },
      "webLink": {
        "description": "URL for the web page for the event on ents24.com",
        "type": "string"
      },
      "fansOnEnts24": {
        "description": "The number of Ents24 users tracking updates and announcements for this event",
        "type": "integer"
      },
      "lastUpdate": {
        "description": "RFC-3339 formatted added/updated timestamp for this object",
        "type": "string"
      },
      "created": {
        "description": "RFC-3339 formatted created timestamp for this object, or null",
        "type": [
          "string",
          "null"
        ]
      }
    }
  }
}
Response  204
HideShow
Headers
Date: Tue, 26 Aug 2014 08:00:00 GMT
Expires: Tue, 26 Aug 2014 09:00:00 GMT
Last-Modified: Tue, 25 Aug 2014 22:10:00 GMT
X-Next-Page: MDg=
X-Previous-Page: ZW0=
X-Total-Items-Found: 75

Read

An event object with all fields.

Event
GET/event/read?id={id}&incl_artists={incl_artists}&incl_images={incl_images}&incl_tickets={incl_tickets}&incl_occurrences={incl_occurrences}&full_description={full_description}

Example URI

GET https://api.ents24.com/event/read?id=mDDaoO&incl_artists=1&incl_images=1&incl_tickets=1&incl_occurrences=1&full_description=1
URI Parameters
HideShow
id
string (required) Example: mDDaoO

Unique identifier string of the Event you want full details for.

incl_artists
boolean (optional) Example: 1

Decides whether or not a list of performing artists is included in the response.

incl_images
boolean (optional) Example: 1

Decides whether or not an event images are included in the response.

incl_tickets
boolean (optional) Example: 1

Decides whether or not a list of available tickets is included in the response.

incl_occurrences
boolean (optional) Example: 1

Decides whether or not a list of individual event occurrences is included in the response.

full_description
boolean (optional) Example: 1

Decides whether full or summarised description text is included in the response.

Request
HideShow
Headers
Authorization: qnFqFAVw8pJMCF1z8tIMYoXwommArRmt9C08jIRA
Response  200
HideShow
Headers
Content-Type: application/json
Date: Tue, 26 Aug 2014 08:00:00 GMT
Expires: Tue, 26 Aug 2014 09:00:00 GMT
Last-Modified: Tue, 25 Aug 2014 22:10:00 GMT
Body
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "title": "Event",
  "description": "A single Event object with all fields",
  "type": "object",
  "properties": {
    "id": {
      "description": "Unique identifier for the event",
      "type": "string"
    },
    "title": {
      "description": "Title of the event",
      "type": [
        "string",
        "null"
      ]
    },
    "headline": {
      "description": "Headline of the event",
      "type": [
        "string",
        "null"
      ]
    },
    "startDate": {
      "description": "RFC-3339 formatted start date for the event",
      "type": "string"
    },
    "endDate": {
      "description": "RFC-3339 formatted end date for the event",
      "type": "string"
    },
    "startTimeString": {
      "description": "Start time string for the event",
      "type": [
        "string",
        "null"
      ]
    },
    "endTimeString": {
      "description": "End time string for the event",
      "type": [
        "string",
        "null"
      ]
    },
    "hasMoved": {
      "description": "Flag to indicate if an event has been moved to another location",
      "type": "boolean"
    },
    "isCancelled": {
      "description": "Flag to indicate if an event has been cancelled",
      "type": "boolean"
    },
    "isPostponed": {
      "description": "Flag to indicate if an event has been postponed",
      "type": "boolean"
    },
    "isRescheduled": {
      "description": "Flag to indicate if an event has been re-scheduled",
      "type": "boolean"
    },
    "isSoldOut": {
      "description": "Flag to indicate whether the event is sold out",
      "type": "boolean"
    },
    "ticketsAvailable": {
      "description": "Flag to indicate whether there are tickets available for the event",
      "type": "boolean"
    },
    "isFree": {
      "description": "Flag to indicate whether the event is free entry",
      "type": "boolean"
    },
    "price": {
      "description": "Price info for the event",
      "type": [
        "string",
        "null"
      ]
    },
    "venue": {
      "description": "Venue the event is being held at",
      "type": "object",
      "properties": {
        "id": {
          "description": "Unique identifier for the venue",
          "type": "string"
        },
        "name": {
          "description": "Name of the venue",
          "type": "string"
        },
        "town": {
          "description": "Town or city where the venue is located",
          "type": "string"
        },
        "location": {
          "description": "Lat/Lon coordinates of the venue",
          "$ref": "http://json-schema.org/geo"
        }
      }
    },
    "description": {
      "description": "Description text for the event",
      "type": [
        "string",
        "null"
      ]
    },
    "artists": {
      "description": "Featured artists",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "description": "Unique identifier for a featured artist",
            "type": "string"
          },
          "name": {
            "description": "Name of a featured artist",
            "type": "string"
          }
        }
      }
    },
    "stages": {
      "description": "Stages at the event",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "description": "Name of the stage",
            "type": "string"
          },
          "days": {
            "description": "Days or timespans performances are occuring on the stage",
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "description": "Unique identifier for the stage day(s)",
                  "type": "string"
                },
                "startDate": {
                  "description": "The start date for this day or time-span",
                  "type": "string"
                },
                "endDate": {
                  "description": "The end date for this day or time-span",
                  "type": "string"
                },
                "artists": {
                  "description": "Performing artists",
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "description": "Unique identifier for a featured artist",
                        "type": "string"
                      },
                      "name": {
                        "description": "Name of a featured artist",
                        "type": "string"
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "occurrences": {
      "description": "The individual occurences of a repeated event (E.G. A theatre show)",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "description": "Unique identifier for the event",
            "type": "string"
          },
          "startDate": {
            "description": "RFC-3339 formatted start date for the event",
            "type": "string"
          },
          "endDate": {
            "description": "RFC-3339 formatted end date for the event",
            "type": "string"
          },
          "startTimeString": {
            "description": "Start time string for the event",
            "type": [
              "string",
              "null"
            ]
          },
          "endTimeString": {
            "description": "End time string for the event",
            "type": [
              "string",
              "null"
            ]
          },
          "hasMoved": {
            "description": "Flag to indicate if an event has been moved to another location",
            "type": "boolean"
          },
          "isCancelled": {
            "description": "Flag to indicate if an event has been cancelled",
            "type": "boolean"
          },
          "isPostponed": {
            "description": "Flag to indicate if an event has been postponed",
            "type": "boolean"
          },
          "isRescheduled": {
            "description": "Flag to indicate if an event has been re-scheduled",
            "type": "boolean"
          },
          "isSoldOut": {
            "description": "Flag to indicate whether the event is sold out",
            "type": "boolean"
          },
          "ticketsAvailable": {
            "description": "Flag to indicate whether there are tickets available for the event",
            "type": "boolean"
          },
          "isFree": {
            "description": "Flag to indicate whether the event is free entry",
            "type": "boolean"
          },
          "price": {
            "description": "Price info for the event",
            "type": [
              "string",
              "null"
            ]
          },
          "tickets": {
            "description": "Tickets for this event",
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "dateTime": {
                  "description": "RFC-3339 formatted date and time this ticket is valid for",
                  "type": "string"
                },
                "supplier": {
                  "description": "The supplier of this ticket",
                  "type": "string"
                },
                "price": {
                  "description": "The face-value price for this ticket",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "totalPrice": {
                  "description": "The total price for this ticket",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "inclBookingFee": {
                  "description": "Flag indicating whether a booking fee is included in the price of this ticket",
                  "type": "boolean"
                },
                "isOnSale": {
                  "description": "Flag indicating whether the ticket is on sale",
                  "type": "boolean"
                },
                "isAvailable": {
                  "description": "Flag indicating whether the ticket is available",
                  "type": "boolean"
                },
                "isPresaleTicket": {
                  "description": "Flag indicating whether the ticket is a pre-sale ticket",
                  "type": "boolean"
                },
                "isResaleTicket": {
                  "description": "Flag indicating whether the ticket is a re-sale ticket",
                  "type": "boolean"
                },
                "onSaleFrom": {
                  "description": "RFC-3339 formatted date this ticket goes on sale",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "onSaleUntil": {
                  "description": "RFC-3339 formatted date this ticket is / will be on sale until",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "url": {
                  "description": "The purchase URL for this ticket",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "email": {
                  "description": "The sales email address for this ticket",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "telephone": {
                  "description": "The sales phone line number for this ticket",
                  "type": [
                    "string",
                    "null"
                  ]
                }
              }
            }
          }
        }
      }
    },
    "images": {
      "description": "Multiple image assets for the event",
      "type": "object",
      "properties": {
        "small": {
          "description": "Small sized image",
          "type": "object",
          "properties": {
            "url": {
              "description": "Image source URL",
              "type": "string"
            },
            "width": {
              "description": "Image width (px)",
              "type": "integer"
            },
            "height": {
              "description": "Image height (px)",
              "type": "integer"
            }
          }
        },
        "medium": {
          "description": "Medium sized image",
          "type": "object",
          "properties": {
            "url": {
              "description": "Image source URL",
              "type": "string"
            },
            "width": {
              "description": "Image width (px)",
              "type": "integer"
            },
            "height": {
              "description": "Image height (px)",
              "type": "integer"
            }
          }
        },
        "large": {
          "description": "Medium sized image",
          "type": "object",
          "properties": {
            "url": {
              "description": "Image source URL",
              "type": "string"
            },
            "width": {
              "description": "Image width (px)",
              "type": "integer"
            },
            "height": {
              "description": "Image height (px)",
              "type": "integer"
            }
          }
        },
        "metadata": {
          "description": "Metadata related to this image",
          "type": "object",
          "properties": {
            "copyright": {
              "description": "The copyright holder for this image",
              "type": [
                "string",
                "null"
              ]
            },
            "caption": {
              "description": "Caption text for this image",
              "type": [
                "string",
                "null"
              ]
            }
          }
        }
      }
    },
    "tickets": {
      "description": "Tickets for this event",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "dateTime": {
            "description": "RFC-3339 formatted date and time this ticket is valid for",
            "type": "string"
          },
          "supplier": {
            "description": "The supplier of this ticket",
            "type": "string"
          },
          "price": {
            "description": "The face-value price for this ticket",
            "type": [
              "string",
              "null"
            ]
          },
          "totalPrice": {
            "description": "The total price for this ticket",
            "type": [
              "string",
              "null"
            ]
          },
          "inclBookingFee": {
            "description": "Flag indicating whether a booking fee is included in the price of this ticket",
            "type": "boolean"
          },
          "isOnSale": {
            "description": "Flag indicating whether the ticket is on sale",
            "type": "boolean"
          },
          "isAvailable": {
            "description": "Flag indicating whether the ticket is available",
            "type": "boolean"
          },
          "isPresaleTicket": {
            "description": "Flag indicating whether the ticket is a pre-sale ticket",
            "type": "boolean"
          },
          "isResaleTicket": {
            "description": "Flag indicating whether the ticket is a re-sale ticket",
            "type": "boolean"
          },
          "onSaleFrom": {
            "description": "RFC-3339 formatted date this ticket goes on sale",
            "type": [
              "string",
              "null"
            ]
          },
          "onSaleUntil": {
            "description": "RFC-3339 formatted date this ticket is / will be on sale until",
            "type": [
              "string",
              "null"
            ]
          },
          "url": {
            "description": "The purchase URL for this ticket",
            "type": [
              "string",
              "null"
            ]
          },
          "email": {
            "description": "The sales email address for this ticket",
            "type": [
              "string",
              "null"
            ]
          },
          "telephone": {
            "description": "The sales phone line number for this ticket",
            "type": [
              "string",
              "null"
            ]
          }
        }
      }
    },
    "genre": {
      "description": "The genre(s) this event is found under",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "webLink": {
      "description": "URL for the web page for the event on ents24.com",
      "type": "string"
    },
    "fansOnEnts24": {
      "description": "The number of Ents24 users tracking updates and announcements for this event",
      "type": "integer"
    },
    "lastUpdate": {
      "description": "RFC-3339 formatted added/updated timestamp for this object",
      "type": "string"
    },
    "created": {
      "description": "RFC-3339 formatted created timestamp for this object, or null",
      "type": [
        "string",
        "null"
      ]
    }
  }
}

Image

An event image retrieved as either a JSON object or JPEG image.

Event Image
GET/event/image?id={id}&size={size}&format={format}

Example URI

GET https://api.ents24.com/event/image?id=mDDaoO&size=medium&format=json
URI Parameters
HideShow
id
string (required) Example: mDDaoO

Unique identifier string of the Event you want an image for.

size
string (optional) Example: medium

Size of image you want [small, medium, large].

format
string (optional) Example: json

The format of the response you want back from the resource [json, file].

Request
HideShow
Headers
Authorization: qnFqFAVw8pJMCF1z8tIMYoXwommArRmt9C08jIRA
Response  200
HideShow
Headers
Content-Type: application/json
Date: Tue, 26 Aug 2014 08:00:00 GMT
Expires: Tue, 26 Aug 2014 09:00:00 GMT
Last-Modified: Tue, 25 Aug 2014 22:10:00 GMT
Body
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "title": "Event Image",
  "description": "An image asset for an event",
  "type": "object",
  "properties": {
    "url": {
      "description": "Image source URL",
      "type": "string"
    },
    "width": {
      "description": "Image width (px)",
      "type": "integer"
    },
    "height": {
      "description": "Image height (px)",
      "type": "integer"
    },
    "metadata": {
      "description": "Metadata related to this image",
      "type": "object",
      "properties": {
        "copyright": {
          "description": "The copyright holder for this image",
          "type": [
            "string",
            "null"
          ]
        },
        "caption": {
          "description": "Caption text for this image",
          "type": [
            "string",
            "null"
          ]
        }
      }
    }
  }
}