> ## Documentation Index
> Fetch the complete documentation index at: https://developer.dizplai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Experiences

> Create, run and read experiences and their widgets, and send fans' votes, at api.dizplai.com.

An **experience** is the set of widgets fans take part in around one match or show, of any types, mixed.

| What you do | What to expect |
| - | - |
| Read experiences and widgets, results included | Current within a second of any change |
| Create and change them | Takes effect at once. A new widget is `hidden` until you make it live |
| Send a fan's vote | Counted once per fan; the results follow within a second |

**Headers.** Every request sends `x-api-key`. Your platform's servers also send an issuer token in `Authorization`; a fan app adds the fan's token on votes. See [Authentication](https://developer.dizplai.com/authentication.md).

**One route per type.** Each widget type has its own routes, such as `/polls`, and every widget shares the fields you see in `GET /experiences`. Polls are in the API reference today; the other types' routes join it soon.

**Statuses.** `scheduled`, `live`, `hidden`, `closed` and `deleted`, plus `locked` and `settled` for predictors. A widget goes live with `PATCH {"status": "live"}`. Lists return live widgets unless you ask for other statuses.

To draw them in your app, see [Drawing widgets](/experiences/rendering.md).

> [!NOTE]
>
> Draft 0.1.0, for review.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.