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 List
GET/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}&order_by={order_by}&order_direction={order_direction}

Example URI

GET https://api.ents24.com/venue/list?name=The Fleece&like=oKkO&location=postcode:SW1X 7LY&radius_distance=10&distance_unit=mi&postcode=SW1X 7LY&results_per_page=25&page=1&incl_image=1&image_size=medium&full_description=0&incl_also_liked=1&updated_since=2015-08-15T15:52:01+00:00&order_by=lastUpdate&order_direction=desc
URI Parameters
HideShow
name
string (optional) Example: The Fleece

The name of a venue.

like
string (optional) Example: oKkO

Unique identifier string of the venue for which you want a list of similar venues.

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.

postcode
string (optional) Example: SW1X 7LY

The 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: 1

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

image_size
string (optional) Example: medium

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

full_description
boolean (optional) Example: 0

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

incl_also_liked
boolean (optional) Example: 1

Decides 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:00

Only retrive venues that have been added/updated 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
integer (optional) Example: 1

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

A venue object with all fields.

Venue
GET/venue/read?id={id}&incl_events={incl_events}&incl_images={incl_images}&incl_also_liked={incl_also_liked}&full_description={full_description}

Example URI

GET https://api.ents24.com/venue/read?id=oKkO&incl_events=1&incl_images=1&incl_also_liked=1&full_description=1
URI Parameters
HideShow
id
string (required) Example: oKkO

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

incl_events
boolean (optional) Example: 1

Decides whether or not a list of events at this venue at is included in the response.

incl_images
boolean (optional) Example: 1

Decides whether or not any venue images are included in the response.

incl_also_liked
boolean (optional) Example: 1

Decides whether or not a list of IDs for similar venues 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": "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"
    }
  }
}

Events

A list of events for a venue.

Venue Events
GET/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

GET https://api.ents24.com/venue/events?id=oKkO&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&order_by=lastUpdate&order_direction=desc
URI Parameters
HideShow
id
string (required) Example: oKkO

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

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 retrive events that have been added/updated 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
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 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"
      }
    }
  }
}

Image

A venue image retrieved as either a JSON object or JPEG image.

Venue Image
GET/venue/image?id={id}&size={size}&format={format}

Example URI

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

Unique identifier string of the venue 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": "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 Widget
GET/venue/widget?id={id}&encode={encode}

Example URI

GET https://api.ents24.com/venue/widget?id=oKkO&encode=utf-8
URI Parameters
HideShow
id
string (required) Example: oKkO

Unique identifier string of the Venue you want widget data for.

encode
string (optional) Example: utf-8

The character encoding for the data response.

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