API Reference - Venue
Venue ¶
Available resources on the Venue API endpoints.
List ¶
Multiple venue objects with selected fields.
NB: You must filter resources retrieved from this end-point with at least one of the following request parameters:
name
location
event_name
Venue ListGET/venue/list?name={name}&like={like}&location={location}&radius_distance={radius_distance}&distance_unit={distance_unit}&postcode={postcode}&results_per_page={results_per_page}&page={page}&incl_image={incl_image}&image_size={image_size}&full_description={full_description}&incl_also_liked={incl_also_liked}&updated_since={updated_since}&created_since={created_since}&order_by={order_by}&order_direction={order_direction}
Example URI
- name
string
(optional) Example: The FleeceThe name of a venue.
- like
string
(optional) Example: oKkOUnique identifier string of the venue for which you want a list of similar venues.
- 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 measurement that should be applied to the
radius distance
value [mi
,km
]. NB: Thelocation
parameter is required when this parameter is set.- postcode
string
(optional) Example: SW1X 7LYThe postcode of the venue(s) you want a listing for. NB: This parameter will only produce a list of venues with the exact postcode given.
- incl_image
boolean
(optional) Example: 1Decides whether or not an artist image is included in the response.
- image_size
string
(optional) Example: mediumChooses the size of image included with each venue object if one is available [
small
,medium
,large
].- full_description
boolean
(optional) Example: 0Decides whether full or summarised description text is included in the response.
- incl_also_liked
boolean
(optional) Example: 1Decides whether or not a list of IDs for similar venues is included in the response.
- updated_since
datetime
(optional) Example: 2015-08-15T15:52:01+00:00Only retrieve venues that have been added/updated since the given timestamp (RFC3339).
- created_since
datetime
(optional) Example: 2015-08-15T15:52:01+00:00Only retrieve venues 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
integer
(optional) Example: 1The 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": "Venue List",
"description": "A list of Venue objects with selected fields",
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"description": "Unique identifier for the venue",
"type": "string"
},
"name": {
"description": "Name of the venue",
"type": "string"
},
"address": {
"description": "The location details for a venue",
"type": "object",
"properties": {
"streetAddress": {
"description": "The building name/number, street name and district",
"type": "array",
"items": {
"type": "string"
},
"minItems": 1
},
"town": {
"description": "Town or city where the venue is located",
"type": "string"
},
"county": {
"description": "The county where the venue is located",
"type": "string"
},
"postcode": {
"description": "Postal code for the venue address",
"type": "string"
},
"country": {
"description": "The country 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 venue",
"type": [
"string",
"null"
]
},
"website": {
"description": "URL for the venues website",
"type": "string"
},
"email": {
"description": "Email address for general enquires",
"type": "string"
},
"phone": {
"description": "Phone numbers for the venue",
"type": "object",
"properties": {
"enquires": {
"description": "Phone number for general enquires",
"type": "string"
},
"booking": {
"description": "Phone number for bookings",
"type": "string"
}
}
},
"events": {
"description": "Upcoming events at the venue",
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"description": "Unique identifier for an event",
"type": "string"
},
"title": {
"description": "Title of an 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"
]
}
}
}
},
"images": {
"description": "Multiple image assets for the venue",
"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"
]
}
}
}
}
},
"webLink": {
"description": "URL for the web page for the venue on ents24.com",
"type": "string"
},
"fansOnEnts24": {
"description": "The number of Ents24 users tracking updates and announcements for this venue",
"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 ¶
A venue object with all fields.
VenueGET/venue/read?id={id}&incl_events={incl_events}&incl_images={incl_images}&incl_also_liked={incl_also_liked}&full_description={full_description}
Example URI
- id
string
(required) Example: oKkOUnique identifier string of the Artist you want full details for.
- incl_events
boolean
(optional) Example: 1Decides whether or not a list of events at this venue at is included in the response.
- incl_images
boolean
(optional) Example: 1Decides whether or not any venue images are included in the response.
- incl_also_liked
boolean
(optional) Example: 1Decides whether or not a list of IDs for similar venues 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": "Venue",
"description": "A single Venue object with all fields",
"type": "object",
"properties": {
"id": {
"description": "Unique identifier for the venue",
"type": "string"
},
"name": {
"description": "Name of the venue",
"type": "string"
},
"address": {
"description": "The location details for a venue",
"type": "object",
"properties": {
"streetAddress": {
"description": "The building name/number, street name and district",
"type": "array",
"items": {
"type": "string"
},
"minItems": 1
},
"town": {
"description": "Town or city where the venue is located",
"type": "string"
},
"county": {
"description": "The county where the venue is located",
"type": "string"
},
"postcode": {
"description": "Postal code for the venue address",
"type": "string"
},
"country": {
"description": "The country 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 venue",
"type": [
"string",
"null"
]
},
"website": {
"description": "URL for the venues website",
"type": "string"
},
"email": {
"description": "Email address for general enquires",
"type": "string"
},
"phone": {
"description": "Phone numbers for the venue",
"type": "object",
"properties": {
"enquires": {
"description": "Phone number for general enquires",
"type": "string"
},
"booking": {
"description": "Phone number for bookings",
"type": "string"
}
}
},
"events": {
"description": "Upcoming events at the venue",
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"description": "Unique identifier for an event",
"type": "string"
},
"title": {
"description": "Title of an 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"
]
}
}
}
},
"images": {
"description": "Multiple image assets for the venue",
"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"
]
}
}
}
}
},
"webLink": {
"description": "URL for the web page for the venue on ents24.com",
"type": "string"
},
"fansAlsoLiked": {
"description": "A list of unique identifier strings for venues similar to this venue",
"type": "array",
"items": {
"type": "string"
}
},
"fansOnEnts24": {
"description": "The number of Ents24 users tracking updates and announcements for this venue",
"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"
]
}
}
}
Events ¶
A list of events for a venue.
Venue EventsGET/venue/events?id={id}&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}&order_by={order_by}&order_direction={order_direction}
Example URI
- id
string
(required) Example: oKkOUnique identifier string of the Venue you want full details for.
- 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).
- 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
Body
{
"$schema": "http://json-schema.org/draft-04/schema#",
"title": "Venue 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"
]
},
"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 occurring 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 occurrences 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"
}
}
}
}
Image ¶
A venue image retrieved as either a JSON object or JPEG image.
Venue ImageGET/venue/image?id={id}&size={size}&format={format}
Example URI
- id
string
(required) Example: oKkOUnique identifier string of the venue 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": "Venue Image",
"description": "An image asset for an venue",
"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"
},
"caption": {
"description": "Caption text for this image",
"type": "string"
}
}
}
}
}
Widget ¶
Return widget data for venue based event listings.
Venue WidgetGET/venue/widget?id={id}&encode={encode}
Example URI
- id
string
(required) Example: oKkOUnique identifier string of the Venue you want widget data for.
- encode
string
(optional) Example: utf-8The character encoding for the data response.
200
Headers
Content-Type: application/json
Date: Tue, 26 Aug 2014 08:00:00 GMT
Expires: Tue, 26 Aug 2014 09:00:00 GMT
Body
{
"$schema": "http://json-schema.org/draft-04/schema#",
"title": "Venue Widget",
"description": "A venue centric event listings widget",
"type": "object",
"properties": {
"jsonLD": {
"description": "Schema.org linked-data formatted event listings",
"type": ["array", "null"],
"items": {
"type": "object",
"properties": {
"@context": {
"description": "The context in which the event data is being described (Schema.org)",
"type": "string"
},
"@type": {
"description": "The type of event the object represents",
"type": "string"
},
"name": {
"description": "The name of the event. This is shown in the rich snippet. See specific policies about event names below",
"type": "string"
},
"url": {
"description": "A link to the event's details page",
"type": "string"
},
"startDate": {
"description": "The starting date and time of the event (ISO8601)",
"type": "string"
},
"endDate": {
"description": "The ending date and time of the event (ISO8601)",
"type": "string"
},
"eventStatus": {
"description": "An eventStatus of an event represents its status; particularly useful when an event is cancelled or rescheduled",
"type": "string"
},
"location": {
"description": "The location of the event",
"type": "object",
"properties": {
"@type": {
"description": "The type of location",
"type": "string"
},
"name": {
"description": "The name of the location",
"type": "string"
},
"address": {
"description": "Physical/Mailing address of the location",
"type": "object",
"properties": {
"@type": {
"description": "The type of address",
"type": "string"
},
"streetAddress": {
"description": "The street address",
"type": "string"
},
"addressLocality": {
"description": " The locality. For example, Mountain View.",
"type": "string"
},
"addressRegion": {
"description": "The region. For example, CA.",
"type": "string"
},
"postalCode": {
"description": "The postal code. For example, 94043.",
"type": "string"
},
"addressCountry": {
"description": "The country. For example, USA or ISO 3166-1 alpha-2 country code.",
"type": "string"
}
}
},
"offers": {
"description": " An offer to buy tickets for this event",
"type": "array",
"items": {
"type": "object",
"properties": {
"@type": {
"description": "The type of offer",
"type": "string"
},
"category": {
"description": "A category for the offer",
"type": "string"
},
"price": {
"description": "The offer price of a product",
"type": "string"
},
"priceCurrency": {
"description": "The currency (in 3-letter ISO 4217 format) of the price",
"type": "string"
},
"availability": {
"description": "The availability of the offer",
"type": "string"
},
"validFrom": {
"description": "The date when the offer becomes valid",
"type": "string"
},
"validThrough": {
"description": "The end of the validity of offer",
"type": "string"
},
"url": {
"description": "URL of the offer",
"type": "string"
}
}
}
},
"image" {
"description": "The URL for the image for this event",
"type": "string"
}
}
}
}
}
},
"data": {
"description": "Venue widget data",
"type": "object",
"properties": {
"name": {
"description": "Name of the venue the event listings are for",
"type": "string"
},
"town": {
"description": "Name of the town/city where the venue is located",
"type": "string"
},
"events": {
"description": "Event listings for the venue",
"type": "array",
"items": {
"type": "object",
"properties": {
"title": {
"description": "Title of 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"
},
"eventUrl": {
"description": "URL for event page",
"type": "string"
},
"isFree": {
"description": "Flag for if event is free",
"type": "boolean"
},
"status": {
"description": "Event status (sold out or not)",
"type": "string"
},
"ticketUrl": {
"description": "URL for tickets",
"type": "string"
},
"image": {
"description": "Image for event",
"type": "string"
},
"trackUrl": {
"description": "URL to track event",
"type": "string"
}
}
}
}
}
}
}
}