GetEventsForCategory

Description

Gets the events for category.

Url Template

https://api.seatwave.com/v2/discovery/category/{categoryId}/events?apikey={apiKey}&siteId={siteid}&pgnumber={pageNumber}&pgsize={pageSize}&what={what}&where={where}&when_from={whenFrom}&when_to={whenTo}&max_price={maxPrice}&eventsWithoutTix={eventsWithoutTix}

Sample URL

https://api.seatwave.com/v2/discovery/category/10/events?apikey=4739E4694D0E482A92C9D0B478D83934&what=music&where=london

Authentication

Supply a valid API key via the apikey query string.

Parameters

  • categoryId ID of category
  • apiKey Valid API key required for authentication
  • siteId Detemines the language and currency of the data in the response
  • pageNumber [OPTIONAL] Page (if not supplied or 0 defaults to 1)
  • pageSize [OPTIONAL] Page size (if not supplied or 0 defaults to 50)
  • what [OPTIONAL] Artist, performer, team, show, category or genre name , part of name, alternate name
  • where [OPTIONAL] Country, town or venue name, part of name, alternate name or UK post code
  • whenFrom [OPTIONAL] Start date [yyyy-mm-dd]
  • whenTo [OPTIONAL] End date [yyyy-mm-dd]
  • maxPrice [OPTIONAL] (if not supplied or 0 no filter is applied)
  • eventsWithoutTix [OPTIONAL] set to true to return events without tickets

Response

EventsResponse

JSON
{"Status":{"Version":"2.0","TimeStampUtc":"\/Date(1537355795000+0100)\/","Code":0,"Message":"Success","Details":""},"Paging":{"PageNumber":1,"PageSize":1,"PageResultCount":1,"TotalResultCount":175,"TotalPageCount":175},"Events":[{"Id":1136173,"Date":"\/Date(1539109800000+0100)\/","EventGroupName":"Procol Harum","VenueName":"London Palladium","Town":"London","Country":"UK","TicketCount":3,"Currency":"GBP","MinPrice":53.1,"SwURL":"https:\/\/www.seatwave.com\/procol-harum-tickets\/london-palladium-tickets\/09-october-2018\/perf\/1136173?affid=167&appid=20115826","EventGroupImageURL":"http:\/\/stwv-s3.global.ssl.fastly.net\/filestore\/season\/image\/procolharum_33498_1_6_20161124105120.png","LayoutId":30278,"EventGroupId":33498,"VenueId":227,"OnSaleDate":"\/Date(1521715708000+0000)\/","SwSellURL":"https:\/\/www.seatwave.com\/sellticketdetails?performanceId=1136173&affid=167&appid=20115826"}]}
XML

  • Events
    • Id The id
    • Date Date and time of the event
    • EventGroupName The name of the artist, performer, sports team etc.
    • Details Additional details such as the name of the support act or in the case of a sports event Team A vs Team B
    • VenueName Name of the venue
    • Town The venue town
    • Country The venue country
    • TicketCount The number of available tickets
    • Currency The minimum price currency (standard 3 letter code)
    • MinPrice The mininum price price of a ticket
    • SwURL URL of the Seatwave event page. This will redirect via an affiliate platform when one has been specified.
    • EventGroupImageURL Artist or performer image URL
    • LayoutId ID of the seating layout
    • EventGroupId ID of the parent event group
    • VenueID ID of the venue
  • Status A status object is returned with every response. It contains details of the success or failure of the request.
    • Version API version
    • TimeStampUtc UTC time stamp
    • Code Error code, 0 indicates success
      = 0: Success
      = 1: Missing / Invalid Version Number
      = 10: Missing / Invalid API Key
      = 11: Missing / Invalid Time Stamp
      = 12: Missing / Invalid Token
      = 20: Authorisation Error
      = 21: Not authorised to access purchase
      = 22: Not authorised to access posting
      = 30: Invalid Input
      = 31: Invalid Client Delivery Details
      = 100: Unable to hold tickets
      = 101: Unable to confirm tickets
      = 200: Unable to hold tickets
      = 1000: API Error
    • Message Code description
    • DelegateAuthorisationCode Error code, 0 indicates success
    • DelegateAuthorisationMessage Authorisation code description
    • Details Further details of the error
  • Paging A paging object is returned with every response that contains a list of entities. It provides details of the total entity count and page size and number.
    • PageNumber The page number of the entities returned
    • PageSize The page size of the entities returned
    • PageResultCount Number of entities returned in this page
    • TotalResultCount Total number of entities
    • TotalPageCount Total page count.