API Reference - Event
Event ¶
Available resources on the Event API endpoints.
Genres ¶
A list of all valid event genres.
Event GenresGET/event/genres?parent_key={parent_key}&parent_genres_only={parent_genres_only}
Example URI
- parent_key
string
(optional) Example: musicThe parent of genre you want a list of genres for. E.G: music, comedy or theatre-shows.
- parent_genres_only
boolean
(optional) Example: 1Decides 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.
Headers
Authorization: qnFqFAVw8pJMCF1z8tIMYoXwommArRmt9C08jIRA
200
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 ListGET/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
- name
string
(optional) Example: Bristol Jazz ShowSearch term for the name of the events to be listed.
- location
string
(optional) Example: postcode:SW1X 7LYThe 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 thename
may be ambiguous E.G: Newcastle. Uselocation/search
endpoint to find a unique location identifier (postcode or lat,lng) that matches the location you want.- radius_distance
integer
(optional) Example: 10The 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: miThe unit of measurment that should be applied to the
radius distance
value [mi
,km
]. NB: Thelocation
parameter is required when this parameter is set.- genre
string
(optional) Example: rockThe genre of event type you want listed.
- date
date
(optional) Example: 2014-09-03A specific date you want an events listing for. NB: This parameter is disregarded if
date from
anddate to
parameters are set in the same request.- date_from
date
(optional) Example: 2014-09-03The 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-10The date you want an events listing to. NB: This parameter is required when
date from
parameter is set.- venue_name
string
(optional) Example: Hyde ParkSearch 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 7LYThe 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: BlondieSearch 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: 1Decides whether or not an event image is included in the response.
- image_size
string
(optional) Example: mediumChooses the size of image included with each image object if one is available [
small
,medium
,large
].- incl_stages
boolean
(optional) Example: 1Decides whether or not a list of stages is included for any festival events in the response.
- incl_artists
boolean
(optional) Example: 1Decides whether or not a list of performing artists is included in the response.
- incl_occurrences
boolean
(optional) Example: 1Decides whether or not a list of individual event occurrences is included for any repeat events in the response.
- incl_tickets
boolean
(optional) Example: 1Decides whether or not a list of available tickets is included in the response.
- full_description
boolean
(optional) Example: 0Decides whether full or summarised description text is included in the response.
- updated_since
datetime
(optional) Example: 2015-08-15T15:52:01+00:00Only retrieve events that have been added/updated since the given timestamp (RFC3339).
- created_since
datetime
(optional) Example: 2015-08-15T15:52:01+00:00Only retrieve events that have been added since the given timestamp (RFC3339).
- results_per_page
integer
(optional) Example: 25The 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: lastUpdateOrder events by the named object property.
- order_direction
string
(optional) Example: descOrdering direction [
asc
,desc
].
Headers
Authorization: qnFqFAVw8pJMCF1z8tIMYoXwommArRmt9C08jIRA
200
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"
]
}
}
}
}
204
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.
EventGET/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
- id
string
(required) Example: mDDaoOUnique identifier string of the Event you want full details for.
- incl_artists
boolean
(optional) Example: 1Decides whether or not a list of performing artists is included in the response.
- incl_images
boolean
(optional) Example: 1Decides whether or not an event images are included in the response.
- incl_tickets
boolean
(optional) Example: 1Decides whether or not a list of available tickets is included in the response.
- incl_occurrences
boolean
(optional) Example: 1Decides whether or not a list of individual event occurrences is included in the response.
- full_description
boolean
(optional) Example: 1Decides whether full or summarised description text is included in the response.
Headers
Authorization: qnFqFAVw8pJMCF1z8tIMYoXwommArRmt9C08jIRA
200
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 ImageGET/event/image?id={id}&size={size}&format={format}
Example URI
- id
string
(required) Example: mDDaoOUnique identifier string of the Event you want an image for.
- size
string
(optional) Example: mediumSize of image you want [
small
,medium
,large
].- format
string
(optional) Example: jsonThe format of the response you want back from the resource [
json
,file
].
Headers
Authorization: qnFqFAVw8pJMCF1z8tIMYoXwommArRmt9C08jIRA
200
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"
]
}
}
}
}
}