GET v1/event/{eventId}?portal={portal}&descriptionFormat={descriptionFormat}

Gets a single event from an event identifier

Request Information

URI Parameters

Name	Description	Type	Additional information
eventId	The event identifier	integer	Required
portal	The portal the request is coming from	string	Required
descriptionFormat	The format the description should be returned in	DescriptionFormat	Default value is PlainText

Body Parameters

None.

Response Information

Resource Description

EventSeries

Name	Description	Type	Additional information
eventId	Identifier for the event. Used to uniquely identify an event	integer	None.
name	The name of the event	string	None.
description	Additional details about the event	string	None.
primaryImage	The image that best represents the event	EventImage	None.
categories	Categories that represent the type of event	Collection of EventCategory	None.
location	Location information for the event	EventLocation	None.
instances	The dates of the event series	Collection of EventInstance	None.
price	Pricing information for the event	Price	None.
lastUpdatedDate	The date the event was last updated in the system	date	None.
popularity	The popularity of the event	integer	None.
interest	The interest level of the event	integer	None.
links	The links for more information on the event	Collection of EventLink	None.
previousEventIds	If an event gets merged in the system, these are the alternate (previous) identifiers	Collection of integer	None.
seriesStart	The start date and time of the event series	date	None.
seriesEnd	The end date and time of the event series	date	None.
url	Url of the event found where the portal is set up at.	string	None.
handPicked	Whether or not the event has been hand picked by admin. Displayed as 'Editors Pick'	boolean	None.
customField	Custom Field defined in Portal	string	None.
contact	Contact Information for the Event	EventContact	None.
media	Videos for the Event primarily from youtube, vimeo and viddler	Collection of string	None.

Response Formats

application/json, text/json

Sample:

{
  "eventId": 123,
  "name": "Save The World Get The Girl & Wired for Havoc & Paper Guns & Star-Off",
  "description": "SOMA PRESENTS: SAVE THE WORLD GET THE GIRL WIRED FOR HAVOC PAPER GUNS all ages 7pm $7 at 24tix.com",
  "primaryImage": {
    "smallImageUrl": "https://citysparkstorage.blob.core.windows.net/portalimages/portalimages/4a49e1e0-a5ec-4df1-a2cb-7458a6c40f13.small.png",
    "mediumImageUrl": "https://citysparkstorage.blob.core.windows.net/portalimages/portalimages/4a49e1e0-a5ec-4df1-a2cb-7458a6c40f13.medium.png",
    "largeImageUrl": "https://citysparkstorage.blob.core.windows.net/portalimages/portalimages/4a49e1e0-a5ec-4df1-a2cb-7458a6c40f13.large.png"
  },
  "categories": [
    {
      "categoryId": 1,
      "parentCategoryId": null,
      "name": "Performing Arts"
    },
    {
      "categoryId": 2,
      "parentCategoryId": 1,
      "name": "Music"
    }
  ],
  "location": {
    "latitude": 40.7600593566895,
    "longitude": -111.888221740723,
    "city": "Salt Lake City",
    "state": "UT",
    "address": "",
    "country": "United States",
    "locationName": "The Shred Shed SLC"
  },
  "instances": [
    {
      "startDateTime": "2025-03-14T18:30:00+00:00",
      "endDateTime": "2025-03-14T22:15:00+00:00",
      "hasTime": false,
      "allDay": false
    },
    {
      "startDateTime": "2025-03-17T18:30:00+00:00",
      "endDateTime": "2025-03-17T22:15:00+00:00",
      "hasTime": false,
      "allDay": false
    }
  ],
  "price": {
    "lowerPrice": 12.5,
    "upperPrice": 35.5,
    "free": false,
    "description": null
  },
  "lastUpdatedDate": "2025-03-12T16:29:08.7545882+00:00",
  "popularity": 55,
  "interest": 70,
  "links": [
    {
      "isSponsor": false,
      "name": "The Shred Shed SLC",
      "linkUrl": "https://www.facebook.com/ajax/events/ticket.php?event_id=1475358502694461&source=12&ext=1398844393&hash=ATXmHa4px1B5WNn5",
      "logoUrl": null
    }
  ],
  "previousEventIds": [
    19
  ],
  "seriesStart": "2025-03-14T18:30:00+00:00",
  "seriesEnd": "2025-03-17T18:30:00+00:00",
  "url": "http://www.yoursite.com/events/details/Save-The-World-Get-The-Girl/123/2014-08-27T10",
  "handPicked": false,
  "customField": null,
  "contact": null,
  "media": null
}

text/xml

Sample:

<EventSeries xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/CitySpark.API.Models">
  <categories>
    <EventCategory>
      <categoryId>1</categoryId>
      <name>Performing Arts</name>
      <parentCategoryId i:nil="true" />
    </EventCategory>
    <EventCategory>
      <categoryId>2</categoryId>
      <name>Music</name>
      <parentCategoryId>1</parentCategoryId>
    </EventCategory>
  </categories>
  <contact i:nil="true" />
  <customField i:nil="true" />
  <description>SOMA PRESENTS: SAVE THE WORLD GET THE GIRL WIRED FOR HAVOC PAPER GUNS all ages 7pm $7 at 24tix.com</description>
  <eventId>123</eventId>
  <handPicked>false</handPicked>
  <instances>
    <EventInstance>
      <allDay>false</allDay>
      <endDateTime>2025-03-14T22:15:00+00:00</endDateTime>
      <hasTime>false</hasTime>
      <startDateTime>2025-03-14T18:30:00+00:00</startDateTime>
    </EventInstance>
    <EventInstance>
      <allDay>false</allDay>
      <endDateTime>2025-03-17T22:15:00+00:00</endDateTime>
      <hasTime>false</hasTime>
      <startDateTime>2025-03-17T18:30:00+00:00</startDateTime>
    </EventInstance>
  </instances>
  <interest>70</interest>
  <lastUpdatedDate>2025-03-12T16:29:08.7545882+00:00</lastUpdatedDate>
  <links>
    <EventLink>
      <isSponsor>false</isSponsor>
      <linkUrl>https://www.facebook.com/ajax/events/ticket.php?event_id=1475358502694461&amp;source=12&amp;ext=1398844393&amp;hash=ATXmHa4px1B5WNn5</linkUrl>
      <logoUrl i:nil="true" />
      <name>The Shred Shed SLC</name>
    </EventLink>
  </links>
  <location>
    <address></address>
    <city>Salt Lake City</city>
    <country>United States</country>
    <latitude>40.7600593566895</latitude>
    <locationName>The Shred Shed SLC</locationName>
    <longitude>-111.888221740723</longitude>
    <state>UT</state>
  </location>
  <media xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays" i:nil="true" />
  <name>Save The World Get The Girl &amp; Wired for Havoc &amp; Paper Guns &amp; Star-Off</name>
  <popularity>55</popularity>
  <previousEventIds xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:long>19</d2p1:long>
  </previousEventIds>
  <price>
    <description i:nil="true" />
    <free>false</free>
    <lowerPrice>12.5</lowerPrice>
    <upperPrice>35.5</upperPrice>
  </price>
  <primaryImage>
    <largeImageUrl>https://citysparkstorage.blob.core.windows.net/portalimages/portalimages/4a49e1e0-a5ec-4df1-a2cb-7458a6c40f13.large.png</largeImageUrl>
    <mediumImageUrl>https://citysparkstorage.blob.core.windows.net/portalimages/portalimages/4a49e1e0-a5ec-4df1-a2cb-7458a6c40f13.medium.png</mediumImageUrl>
    <smallImageUrl>https://citysparkstorage.blob.core.windows.net/portalimages/portalimages/4a49e1e0-a5ec-4df1-a2cb-7458a6c40f13.small.png</smallImageUrl>
  </primaryImage>
  <seriesEnd>2025-03-17T18:30:00+00:00</seriesEnd>
  <seriesStart>2025-03-14T18:30:00+00:00</seriesStart>
  <url>http://www.yoursite.com/events/details/Save-The-World-Get-The-Girl/123/2014-08-27T10</url>
</EventSeries>