GetCategoriesForGenre

Description

Returns a paged list of all categories for a given parent genre.

Url Template

https://api.seatwave.com/v2/discovery/genre/{genreId}/categories?apikey={apiKey}&siteId={siteid}&pgnumber={pageNumber}&pgsize={pageSize}

Sample URL

https://api.seatwave.com/v2/discovery/genre/1/categories?apikey=4739E4694D0E482A92C9D0B478D83934

Authentication

Supply a valid API key via the apikey query string.

Parameters

  • genreId ID of the genre
  • 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)

Response

CategoriesResponse

JSON
{"Status":{"Version":"2.0","TimeStampUtc":"\/Date(1531997506000+0100)\/","Code":0,"Message":"Success","Details":""},"Paging":{"PageNumber":1,"PageSize":1,"PageResultCount":1,"TotalResultCount":24,"TotalPageCount":24},"Categories":[{"Id":91,"Name":"Blues","GenreId":1}]}
XML

  • Categories A category is second level of the Seatwave event hierarchy, for example Classic Rock, RnB and Country
    • Id The id.
    • Name The name.
    • GenreId ID of the parent genre
  • 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.