Web Services


Get a paginated list of all events recommended to a user by, based on their listening profile.


limit (Optional) : The number of results to fetch per page. Defaults to 20.
page (Optional) : The page number to scan to.
latitude (Optional) : Optionally find events at a particular location (must be paired with a valid longitude)
longitude (Optional) : Optionally find events at a particular location (must be paired with a valid latitude)
festivalsonly[0|1] (Optional) : Whether only festivals should be returned, or all events.
country (Optional) : Optionally find events in a particular country (use EITHER lat/long or country)
api_key (Required) : A API key.
api_sig (Required) : A method signature. See authentication for more information.
sk (Required) : A session key generated by authenticating a user via the authentication protocol.


This service requires authentication. Please see our authentication how-to.

Sample Response

<events user="RJ" page="1" perPage="20" totalPages="5" total="100">
    <title>Night Slugs presents: TROUBLE & BASS</title>
      <artist>Drop the Lime</artist>
      <artist>Math Head</artist>
      <artist>L-VIS 1990</artist>
      <artist>The Captain</artist>
      <artist>Bok Bok</artist>
      <artist>Star Eyes</artist>
      <headliner>Drop the Lime</headliner>
      <name>East Village</name>
        <country>United Kingdom</country>
        <street>89 Great Eastern Street</street>
        <postalcode>EC2A 3HX</postalcode>
    <startDate>Thu, 23 Oct 2008 21:00:00</startDate>
    <image size="small">...</image>
    <image size="medium">...</image>
    <image size="large">...</image>
        <ticket supplier="...">http://...</ticket>


  • 2 : Invalid service - This service does not exist
  • 3 : Invalid Method - No method with that name in this package
  • 4 : Authentication Failed - You do not have permissions to access the service
  • 5 : Invalid format - This service doesn't exist in that format
  • 6 : Invalid parameters - Your request is missing a required parameter
  • 7 : Invalid resource specified
  • 8 : Operation failed - Something else went wrong
  • 9 : Invalid session key - Please re-authenticate
  • 10 : Invalid API key - You must be granted a valid key by
  • 11 : Service Offline - This service is temporarily offline. Try again later.
  • 13 : Invalid method signature supplied
  • 16 : There was a temporary error processing your request. Please try again
  • 26 : Suspended API key - Access for your account has been suspended, please contact
  • 29 : Rate limit exceeded - Your IP has made too many requests in a short period