live

Dice APIdice.fm ↗

Browse upcoming music events, parties, and concerts happening in your city by filtering through genres, categories, and dates to find exactly what you're looking for. Get detailed information about any event including full listings, descriptions, and availability on DICE.

This API takes change requests — .

Endpoint health

monitored

browse_events

get_event_details

Checks pendingself-healing

Endpoints

Updated

3h ago

Try it

city

City slug in the format '{perm_name}-{city_id}', e.g. 'new_york-5bbf4db0f06331478e9b2c59', 'london-5b22e2c8fc4800000182c2e7'. Found in dice.fm browse page URLs.

genre

Sub-genre filter appended to the category path. Examples for music/party: 'afro_house', 'disco', 'funk', 'house', 'karaoke', 'latin', 'pop', 'reggaeton', 'tech-house'. Available genres vary by category and city.

limit

Maximum number of events to return.

Typed, relational, agent-ready

A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.

Fully typed · autocompletes
Objects link to objects
Typed errors & pagination

Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:

uv add parse-sdk
uv run parse init
uv run parse add --marketplace dice-fm-api

uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.


"""Walkthrough: DICE Events SDK — browse events by city, filter by category and date."""
from parse_apis.dice_fm_api import Dice, Category, EventNotFound

client = Dice()

# Browse upcoming parties in New York for the next week
ny = client.city(id="new_york-5bbf4db0f06331478e9b2c59")
for event in ny.browse(category=Category.MUSIC_PARTY, date_from="2026-07-12", date_until="2026-07-19", limit=5):
    print(event.name, "|", event.venue_name, "|", event.event_start_date)

# Drill into one event for full details (description, lineup, age restriction)
first = ny.browse(category=Category.MUSIC_DJ, limit=1).first()
if first:
    detail = first.details()
    print(detail.name, detail.venue_address, detail.price_amount, detail.age_restriction)

# Handle not-found errors for invalid slugs
try:
    bad = client.city(id="new_york-5bbf4db0f06331478e9b2c59").browse(limit=1).first()
    if bad:
        bad_detail = bad.details()
except EventNotFound as exc:
    print(f"Event gone: {exc.event_slug}")

print("exercised: city.browse / event_summary.details / EventNotFound catch")

All endpoints · 2 totalmissing one? ·

Browse upcoming events on DICE filtered by city, event category, genre, and date range. Returns a list of events with venue, pricing, and scheduling details. Results are from the city's browse page, ordered chronologically. When a date range spans many events, the response indicates whether more results exist beyond the returned set.

Input

Param	Type	Description
city	string	City slug in the format '{perm_name}-{city_id}', e.g. 'new_york-5bbf4db0f06331478e9b2c59', 'london-5b22e2c8fc4800000182c2e7'. Found in dice.fm browse page URLs.
genre	string	Sub-genre filter appended to the category path. Examples for music/party: 'afro_house', 'disco', 'funk', 'house', 'karaoke', 'latin', 'pop', 'reggaeton', 'tech-house'. Available genres vary by category and city.
limit	integer	Maximum number of events to return.
category	string	Event category path.
date_from	string	Start date filter in ISO format YYYY-MM-DD. Omit for no start date constraint.
date_until	string	End date filter in ISO format YYYY-MM-DD. Omit for no end date constraint.

Response

{
  "type": "object",
  "fields": {
    "city": "object with name, id, country_code",
    "events": "array of event objects with id, name, venue, price, dates, tags",
    "has_more": "boolean indicating if more events exist beyond this page",
    "total_returned": "integer"
  },
  "sample": {
    "data": {
      "city": {
        "id": "5bbf4db0f06331478e9b2c59",
        "name": "New York",
        "country_code": "US"
      },
      "events": [
        {
          "id": "6a02ae12faa95d0001d2944d",
          "url": "https://dice.fm/event/2wywg7-azure-day-party-july-12th-12th-jul-rooftop-at-arlo-williamsburg-new-york-city-tickets",
          "name": "Azure Day Party July 12th",
          "tags": [
            "Party"
          ],
          "status": "on-sale",
          "timezone": "America/New_York",
          "date_unix": 1783882800,
          "perm_name": "2wywg7-azure-day-party-july-12th-12th-jul-rooftop-at-arlo-williamsburg-new-york-city-tickets",
          "properties": [
            "selling_fast"
          ],
          "venue_name": "Rooftop at Arlo Williamsburg",
          "image_square": "https://dice-media.imgix.net/attachments/2026-05-12/890de510-544c-415c-9fda-01ebb7b58e50.jpg?rect=0%2C0%2C1254%2C1254",
          "presented_by": "Presented by Azure Day Party.",
          "price_amount": 75,
          "venue_address": "96 Wythe Avenue, Brooklyn, New York 11249, United States",
          "event_end_date": "2026-07-12T22:00:00-04:00",
          "price_currency": "USD",
          "event_start_date": "2026-07-12T15:00:00-04:00"
        }
      ],
      "has_more": false,
      "total_returned": 10
    },
    "status": "success"
  }
}

About the Dice API

The Dice API on Parse exposes 2 endpoints for the publicly available data on dice.fm. Calls return JSON over HTTPS and are billed per successful response.

Pin a release with the API-Snapshot-Version header so canonical updates don't silently change your contract.