POST list_events
Your events in MIO with state, dates, venue and total allocation.
read
Lists the events of your MIO account, soonest first. Filter by state or start date to find tonight's show or everything still in draft. Use the event_id from each item in the other tools. Pages hold up to 100 events; pass next_cursor back as cursor.
POST /api/v1/dice/list_events
Input
| Parameter | Type | Description |
|---|---|---|
| state | enum | draft, submitted, review, approved, declined, cancelled or archived. Default: all. |
| starts_after | date | Only events starting on or after this date. |
| starts_before | date | Only events starting before this date. |
| limit | integer | 1 to 100. Default: 25. |
| cursor | string | Next page cursor from the previous call. |
Example response
{
"events": [
{
"event_id": "ev_48213",
"name": "Club Night",
"state": "approved",
"start": "2026-11-14T22:00:00+00:00",
"venue": "The Warehouse",
"allocation": 350
},
{
"event_id": "ev_48377",
"name": "Rooftop Session",
"state": "draft",
"start": "2026-12-05T19:00:00+00:00",
"venue": "Skyline Terrace",
"allocation": 200
}
],
"next_cursor": null
}