# List hosted events Retrieve a list of all events registered by this event host. Endpoint: GET /hosts/{host}/events Version: 3.0.0 Security: SessionKey ## Path parameters: - `host` (integer, required) Unique identifier of the requested host ## Query parameters: - `records` (integer) The number of records per page that should be returned - `page` (integer) The number of the results page to return - `region` (string) If set, only returns events being hosted in the specified region - `title` (string) If set, only returns events whose title matches the specified regular expression - `status` (string) If set, only returns events with the specified status Enum: "Draft", "Under Review", "Scheduled", "Listed", "Cancelled", "Staged" - `active` (boolean) Only returns future events if set to true, or past events if set to false - `public` (boolean) Only returns public events if set to true, or private events if set to false. - `sort` (string) If set, determines how the returned events list is sorted Enum: "alphabetical", "published", "popularity", "start" - `order` (string) If set along with the 'sort' parameter, determines whether the results will be sorted in ascending or descending order. Enum: "asc", "desc" ## Response 200 fields (application/json): - `total` (integer) The total number of results available - `page` (integer) The number of the results page returned - `records` (integer) The maximum number of results returned per page - `entries` (array) - `entries.self` (string) URI of the event resource - `entries.published` (string) The date and time at which the event was published - `entries.title` (string) Unique name of the event - `entries.description` (string) Long form text detailing what the event is about, including performing acts, amenities and additional information important to potential attendees - `entries.status` (string) Current status of the event - `entries.type` (string) Nature of the event. Determines what information is collected on ticket purchase. - `entries.public` (boolean) Whether or not the event is open to the general public - `entries.category` (object) - `entries.category.self` (string) URI of the event category resource - `entries.category.name` (string) Unique name of the event category - `entries.category.subcategories` (array) List of subtypes associated with this category - `entries.subcategory` (string) Subcategory under which the event is classified - `entries.start` (string) The date and time at which the event is scheduled to begin - `entries.end` (string) The date and time at which the event is scheduled to finish - `entries.venue` (object) The location at which the event is taking place - `entries.venue.self` (string) URI of the venue resource - `entries.venue.name` (string) Name of the event venue - `entries.venue.region` (string) URI of the region resource related to this venue - `entries.venue.latitude` (number) Global latitude of the event venue's location - `entries.venue.longitude` (number) Global longitude of the event venue's location - `entries.venue.address` (string) Text representation of the event venue's address - `entries.venue.map` (string) URI to a static Google Maps image of the event venue's location - `entries.host` (object) - `entries.host.self` (string) URI of the host resource - `entries.host.name` (string) Unique name of the event host - `entries.host.contact` (string) First and last name of the event host's primary contact person - `entries.host.email` (string) Primary contact email address of the event host - `entries.host.description` (string) Brief description of the nature of the events put on by the host - `entries.host.phone` (string) Primary contact number of the event host - `entries.host.website` (string) URL of the event host's website, if one exists - `entries.host.country` (string) The country in which the host's events will be primarily staged - `entries.host.firstAddressLine` (string) The first line of the event host's mailing address - `entries.host.secondAddressLine` (string) The second line of the event host's mailing address - `entries.host.city` (string) The city portion of the event host's mailing address - `entries.host.state` (string) The state, parish or district portion of the event host's mailing address - `entries.host.businessNo` (string) The event host's unique registration number, if it maintains a registered business entity - `entries.host.administrators` (string) URI of the host's administrative user collection - `entries.host.events` (string) URI of the collection of events being staged by this host - `entries.disclaimer` (string) Subcategory under which the event is classified - `entries.tags` (array) List of short phrases that can be used to search and share the event - `entries.banner` (string) URI of the event's banner image - `entries.thumbnail` (string) URI of the event's thumbnail image - `entries.popularity` (integer) Score indicating how much activity the event is generating. - `entries.sections` (array) A list of the event's subdivisions, each of which offer a unique experience to ticket holders (E.g. General, VIP, Backstage, etc.) - `entries.sections.self` (string) URI of the event section resource - `entries.sections.name` (string) Name of the event section - `entries.sections.description` (string) Details of the unique experience customers can expect when purchasing tickets to this event section - `entries.sections.basePrice` (number) Cost of tickets to this event section before the application of any price modifiers - `entries.sections.salesStart` (string) The date and time at which tickets for this event section go on sale - `entries.sections.salesEnd` (string) The date and time at which ticket sales for this event section close - `entries.sections.active` (boolean) Whether or not tickets for this event section are currently on sale - `entries.sections.capacity` (integer) The maximum number of tickets that can be issued for this event section - `entries.sections.sold` (integer) The number of tickets sold for this event section - `entries.sections.remaining` (integer) The number of event section tickets available for sale - `entries.sections.reserved` (integer) The number of event section tickets held by ongoing orders ## Response 404 fields (application/json): - `message` (string) Reason for the given response.