# List assigned advertisements

Retrieve the list of approved, currently active advertisements assigned to this zone.

Endpoint: GET /zones/{zone}/advertisements
Version: 3.0.0
Security: SessionKey

## Path parameters:

  - `zone` (integer, required)
    Unique identifier of the requested advertising zone

## Query parameters:

  - `records` (integer)
    The number of records per page that should be returned

  - `page` (integer)
    The number of the results page to return

## 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)
    List of advertisements matching the given criteria

  - `entries.self` (string)
    URI of the advertisement resource

  - `entries.name` (string)
    Unique name of the advertisement

  - `entries.description` (string)
    Long form text detailing the aims and objectives of the advertisement
and any other relevant information

  - `entries.status` (string)
    Current status of the advertisement

  - `entries.artwork` (string)
    URI of the advertisement's artwork

  - `entries.zones` (array)
    List of zones the advertisement is assigned to

  - `entries.zones.self` (string)
    URI of the advertising zone resource

  - `entries.zones.name` (string)
    Unique name of the advertising zone

  - `entries.zones.description` (string)
    Text detailing where this zone appears (Events App, Website, etc.)
and the type of advertising it will display

  - `entries.zones.number` (string)
    System generated alphanumeric string that uniquely identifies the advertising zone

  - `entries.zones.width` (number)
    The width (in pixels) that advertisements assigned to this zone must adhere to

  - `entries.zones.height` (number)
    The height (in pixels) that advertisements assigned to this zone must adhere to

  - `entries.zones.advertisements` (string)
    URI of the collection of advertisements assigned to this zone

  - `entries.schedule` (array)
    List of time slots at which to display the advertisement in its
allocated zones

  - `entries.schedule.start` (string)
    The date and time from which the advertisement is scheduled to be displayed

  - `entries.schedule.end` (string)
    The date and time until which the advertisement is scheduled to be displayed

  - `entries.event` (object)
    The event that this advertisement is promoting

  - `entries.event.self` (string)
    URI of the event resource

  - `entries.event.published` (string)
    The date and time at which the event was published

  - `entries.event.title` (string)
    Unique name of the event

  - `entries.event.description` (string)
    Long form text detailing what the event is about, including performing acts,
amenities and additional information important to potential attendees

  - `entries.event.status` (string)
    Current status of the event

  - `entries.event.type` (string)
    Nature of the event. Determines what information is collected on ticket purchase.

  - `entries.event.public` (boolean)
    Whether or not the event is open to the general public

  - `entries.event.category` (object)

  - `entries.event.category.self` (string)
    URI of the event category resource

  - `entries.event.category.name` (string)
    Unique name of the event category

  - `entries.event.category.subcategories` (array)
    List of subtypes associated with this category

  - `entries.event.subcategory` (string)
    Subcategory under which the event is classified

  - `entries.event.start` (string)
    The date and time at which the event is scheduled to begin

  - `entries.event.end` (string)
    The date and time at which the event is scheduled to finish

  - `entries.event.venue` (object)
    The location at which the event is taking place

  - `entries.event.venue.self` (string)
    URI of the venue resource

  - `entries.event.venue.name` (string)
    Name of the event venue

  - `entries.event.venue.region` (string)
    URI of the region resource related to this venue

  - `entries.event.venue.latitude` (number)
    Global latitude of the event venue's location

  - `entries.event.venue.longitude` (number)
    Global longitude of the event venue's location

  - `entries.event.venue.address` (string)
    Text representation of the event venue's address

  - `entries.event.venue.map` (string)
    URI to a static Google Maps image of the event venue's location

  - `entries.event.host` (object)

  - `entries.event.host.self` (string)
    URI of the host resource

  - `entries.event.host.name` (string)
    Unique name of the event host

  - `entries.event.host.contact` (string)
    First and last name of the event host's primary contact person

  - `entries.event.host.email` (string)
    Primary contact email address of the event host

  - `entries.event.host.description` (string)
    Brief description of the nature of the events put on by the host

  - `entries.event.host.phone` (string)
    Primary contact number of the event host

  - `entries.event.host.website` (string)
    URL of the event host's website, if one exists

  - `entries.event.host.country` (string)
    The country in which the host's events will be primarily staged

  - `entries.event.host.firstAddressLine` (string)
    The first line of the event host's mailing address

  - `entries.event.host.secondAddressLine` (string)
    The second line of the event host's mailing address

  - `entries.event.host.city` (string)
    The city portion of the event host's mailing address

  - `entries.event.host.state` (string)
    The state, parish or district portion of the event host's mailing address

  - `entries.event.host.businessNo` (string)
    The event host's unique registration number, if it maintains a registered business entity

  - `entries.event.host.administrators` (string)
    URI of the host's administrative user collection

  - `entries.event.host.events` (string)
    URI of the collection of events being staged by this host

  - `entries.event.disclaimer` (string)
    Subcategory under which the event is classified

  - `entries.event.tags` (array)
    List of short phrases that can be used to search and share the event

  - `entries.event.banner` (string)
    URI of the event's banner image

  - `entries.event.thumbnail` (string)
    URI of the event's thumbnail image

  - `entries.event.popularity` (integer)
    Score indicating how much activity the event is generating.

  - `entries.event.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.event.sections.self` (string)
    URI of the event section resource

  - `entries.event.sections.name` (string)
    Name of the event section

  - `entries.event.sections.description` (string)
    Details of the unique experience customers can expect when purchasing tickets to this event section

  - `entries.event.sections.basePrice` (number)
    Cost of tickets to this event section before the application of any price modifiers

  - `entries.event.sections.salesStart` (string)
    The date and time at which tickets for this event section go on sale

  - `entries.event.sections.salesEnd` (string)
    The date and time at which ticket sales for this event section close

  - `entries.event.sections.active` (boolean)
    Whether or not tickets for this event section are currently on sale

  - `entries.event.sections.capacity` (integer)
    The maximum number of tickets that can be issued for this event section

  - `entries.event.sections.sold` (integer)
    The number of tickets sold for this event section

  - `entries.event.sections.remaining` (integer)
    The number of event section tickets available for sale

  - `entries.event.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.