Filtered event list
A filtered slice of the catalogue near a location — one of DICE's browse categories (tonight, this week, new, most viewed, top shows, festivals, late night, comedy, culture) or a date range (by_date).
Costs 2 credits per request.
Authorization
ApiKeyAuth API key created in the extractr dashboard (ext_live_...). Also accepted as Authorization: Bearer.
In: header
Query Parameters
-90 <= value <= 90-180 <= value <= 180DICE browse category. Defaults to by_date when from_date/to_date is set, otherwise this_week. by_date with no dates covers the next 7 days. The older values music, nightlife, arts and film are still accepted and map to the nearest current category.
Value in
- "tonight"
- "this_week"
- "by_date"
- "new"
- "most_viewed"
- "top_shows"
- "festivals"
- "late_night"
- "comedy"
- "culture"
- "music"
- "nightlife"
- "arts"
- "film"
date or recommended; omit for the category's own order. popularity is an alias of recommended; distance is accepted and ignored (DICE no longer sorts by it).
Value in
- "date"
- "recommended"
- "popularity"
- "distance"
datedate1 <= value <= 5020Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/dice/list_events"{ "count": 0, "category": "string", "sorted_by": "string", "events": [ { "id": "6a537c5e3bebf0000107926c", "name": "Percolate presents Overmono", "status": "on-sale", "url": "https://dice.fm/event/6a537c5e3bebf0000107926c", "images": { "square": "https://dice-media.imgix.net/a1b2c3.jpg", "landscape": "string" }, "venue": { "id": 12903, "name": "Village Underground", "address": "54 Holywell Lane", "city": "London", "country_code": "GB", "latitude": 51.5266, "longitude": -0.078 }, "date": { "start": "2026-09-12T20:00:00.000Z", "end": "2026-09-13T03:00:00.000Z", "timezone": "Europe/London", "on_sale": "2026-07-01T09:00:00.000Z" }, "price": { "amount": 2500, "currency": "GBP", "amount_from": 1500, "display": "£25.00" }, "lineup": [ "Overmono", "Anz" ], "tag": "techno" } ]}{ "error": { "code": "invalid_api_key", "message": "The provided API key is invalid or has been revoked.", "reason": "sold" }}{ "error": { "code": "invalid_api_key", "message": "The provided API key is invalid or has been revoked.", "reason": "sold" }}{ "error": { "code": "invalid_api_key", "message": "The provided API key is invalid or has been revoked.", "reason": "sold" }}{ "error": { "code": "invalid_api_key", "message": "The provided API key is invalid or has been revoked.", "reason": "sold" }}{ "error": { "code": "invalid_api_key", "message": "The provided API key is invalid or has been revoked.", "reason": "sold" }}{ "error": { "code": "invalid_api_key", "message": "The provided API key is invalid or has been revoked.", "reason": "sold" }}{ "error": { "code": "invalid_api_key", "message": "The provided API key is invalid or has been revoked.", "reason": "sold" }}