# Dizplai API

- [Overview](https://developer.dizplai.com/index.md): Live fan engagement for your platform, through the Dizplai API.
- [Versions and changes](https://developer.dizplai.com/guides/versioning.md): What can change within v1, and how we retire a version.
- [Write API](https://developer.dizplai.com/authoring/overview.md): The only way to create, change and run experiences and their items. Internal: DizCore and the DX console only.
- [Events](https://developer.dizplai.com/authoring/events.md): Hear what happens on the fan side as it happens, without polling. Internal.
- [Choosing a widget type](https://developer.dizplai.com/authoring/choosing-a-widget-type.md): Which widget type fits the moment, with sport and non-sport examples.
- [Poll](https://developer.dizplai.com/authoring/poll.md): Fans vote once from a short list of options. The crowd's answer is the point.
- [Rating](https://developer.dizplai.com/authoring/rating.md): Fans score one or more people on a scale of 1 to 5 or 1 to 10.
- [Picker](https://developer.dizplai.com/authoring/picker.md): Fans pick their own favourite through quick head-to-head rounds against a timer.
- [Predictor](https://developer.dizplai.com/authoring/predictor.md): Fans predict the final score between two teams. Results group the predictions by score line.
- [Line-up](https://developer.dizplai.com/authoring/lineup.md): Fans pick a starting line-up, player by position, and a formation. Football and volleyball.
- [Messaging (Fan Zone)](https://developer.dizplai.com/authoring/messaging.md): Fans reply to a prompt in their own words. Every message is moderated.
- [Sponsor](https://developer.dizplai.com/authoring/sponsor.md): Display only: sponsor slots, adverts or information, with optional links.
- [Quiz](https://developer.dizplai.com/authoring/quiz.md): Planned. Fans answer 1 to 20 questions, each with one correct answer, revealed once the quiz is marked.
- [List experiences with their items](https://developer.dizplai.com/api-reference/experiences/list-experiences-with-their-items.md): Newest created first. Each experience comes with its items in full, results included.
- [Create an experience](https://developer.dizplai.com/api-reference/experiences/create-an-experience.md): Saved in DX first, then sent to the fan side. It has no items yet, so fans don't see it.
- [Get one experience](https://developer.dizplai.com/api-reference/experiences/get-one-experience.md)
- [Update an experience or retire it](https://developer.dizplai.com/api-reference/experiences/update-an-experience-or-retire-it.md): Send only the fields to change. status deleted retires it and every item in it.
- [List the widget types](https://developer.dizplai.com/api-reference/widget-types/list-the-widget-types.md): What each type is for, when to use another, and an example body. enabled says whether this client can create it.
- [Get one widget type](https://developer.dizplai.com/api-reference/widget-types/get-one-widget-type.md)
- [List polls](https://developer.dizplai.com/api-reference/poll-api/list-polls.md)
- [Create a poll](https://developer.dizplai.com/api-reference/poll-api/create-a-poll.md): Created hidden unless you send status scheduled or live, so fans see it only once it's made live. Proxied by DizCore for clients; called directly by the console.
- [Get a poll with its results](https://developer.dizplai.com/api-reference/poll-api/get-a-poll-with-its-results.md)
- [Update a poll or change its status](https://developer.dizplai.com/api-reference/poll-api/update-a-poll-or-change-its-status.md): Send only the fields to change, or a new status. An invalid status transition answers 400.
- [Get a poll's results](https://developer.dizplai.com/api-reference/poll-api/get-a-polls-results.md): All of its results, whatever results_visibility says, from the fan side's full results document, cached for one second. For consoles and overlays: poll every second while it's live.
- [Cast a fan's vote](https://developer.dizplai.com/api-reference/poll-api/cast-a-fans-vote.md): DizCore only, on the private API. The client's app sends the fan's token from the client's own login; DizCore checks the app's key and its per-client limits, then forwards the vote unchanged, with that token in x-dizplai-fan-token. DX checks the token, works out the fan itself and applies the per-fa…
- [List ratings](https://developer.dizplai.com/api-reference/rating-api/list-ratings.md)
- [Create a rating](https://developer.dizplai.com/api-reference/rating-api/create-a-rating.md): Created hidden unless you send status scheduled or live, so fans see it only once it's made live. Proxied by DizCore for clients; called directly by the console.
- [Get a rating with its results](https://developer.dizplai.com/api-reference/rating-api/get-a-rating-with-its-results.md)
- [Update a rating or change its status](https://developer.dizplai.com/api-reference/rating-api/update-a-rating-or-change-its-status.md): Send only the fields to change, or a new status. An invalid status transition answers 400.
- [Get a rating's results](https://developer.dizplai.com/api-reference/rating-api/get-a-ratings-results.md): All of its results, whatever results_visibility says, from the fan side's full results document, cached for one second. For consoles and overlays: poll every second while it's live.
- [Cast a fan's vote](https://developer.dizplai.com/api-reference/rating-api/cast-a-fans-vote.md): DizCore only, on the private API. The client's app sends the fan's token from the client's own login; DizCore checks the app's key and its per-client limits, then forwards the vote unchanged, with that token in x-dizplai-fan-token. DX checks the token, works out the fan itself and applies the per-fa…
- [List pickers](https://developer.dizplai.com/api-reference/picker-api/list-pickers.md)
- [Create a picker](https://developer.dizplai.com/api-reference/picker-api/create-a-picker.md): Created hidden unless you send status scheduled or live, so fans see it only once it's made live. Proxied by DizCore for clients; called directly by the console.
- [Get a picker with its results](https://developer.dizplai.com/api-reference/picker-api/get-a-picker-with-its-results.md)
- [Update a picker or change its status](https://developer.dizplai.com/api-reference/picker-api/update-a-picker-or-change-its-status.md): Send only the fields to change, or a new status. An invalid status transition answers 400.
- [Get a picker's results](https://developer.dizplai.com/api-reference/picker-api/get-a-pickers-results.md): All of its results, whatever results_visibility says, from the fan side's full results document, cached for one second. For consoles and overlays: poll every second while it's live.
- [Cast a fan's vote](https://developer.dizplai.com/api-reference/picker-api/cast-a-fans-vote.md): DizCore only, on the private API. The client's app sends the fan's token from the client's own login; DizCore checks the app's key and its per-client limits, then forwards the vote unchanged, with that token in x-dizplai-fan-token. DX checks the token, works out the fan itself and applies the per-fa…
- [List predictors](https://developer.dizplai.com/api-reference/predictor-api/list-predictors.md)
- [Create a predictor](https://developer.dizplai.com/api-reference/predictor-api/create-a-predictor.md): Created hidden unless you send status scheduled or live, so fans see it only once it's made live. Proxied by DizCore for clients; called directly by the console.
- [Get a predictor with its results](https://developer.dizplai.com/api-reference/predictor-api/get-a-predictor-with-its-results.md)
- [Update a predictor or change its status](https://developer.dizplai.com/api-reference/predictor-api/update-a-predictor-or-change-its-status.md): Send only the fields to change, or a new status. An invalid status transition answers 400. Settle with status settled and both teams' score; a later settle is a correction. Lock with status locked.
- [Get a predictor's results](https://developer.dizplai.com/api-reference/predictor-api/get-a-predictors-results.md): All of its results, whatever results_visibility says, from the fan side's full results document, cached for one second. For consoles and overlays: poll every second while it's live.
- [Cast a fan's vote](https://developer.dizplai.com/api-reference/predictor-api/cast-a-fans-vote.md): DizCore only, on the private API. The client's app sends the fan's token from the client's own login; DizCore checks the app's key and its per-client limits, then forwards the vote unchanged, with that token in x-dizplai-fan-token. DX checks the token, works out the fan itself and applies the per-fa…
- [List line-ups](https://developer.dizplai.com/api-reference/line-up-api/list-line-ups.md)
- [Create a line-up](https://developer.dizplai.com/api-reference/line-up-api/create-a-line-up.md): Created hidden unless you send status scheduled or live, so fans see it only once it's made live. Proxied by DizCore for clients; called directly by the console.
- [Get a line-up with its results](https://developer.dizplai.com/api-reference/line-up-api/get-a-line-up-with-its-results.md)
- [Update a line-up or change its status](https://developer.dizplai.com/api-reference/line-up-api/update-a-line-up-or-change-its-status.md): Send only the fields to change, or a new status. An invalid status transition answers 400.
- [Get a line-up's results](https://developer.dizplai.com/api-reference/line-up-api/get-a-line-ups-results.md): All of its results, whatever results_visibility says, from the fan side's full results document, cached for one second. For consoles and overlays: poll every second while it's live.
- [Cast a fan's vote](https://developer.dizplai.com/api-reference/line-up-api/cast-a-fans-vote.md): DizCore only, on the private API. The client's app sends the fan's token from the client's own login; DizCore checks the app's key and its per-client limits, then forwards the vote unchanged, with that token in x-dizplai-fan-token. DX checks the token, works out the fan itself and applies the per-fa…
- [List Fan Zones](https://developer.dizplai.com/api-reference/messaging-api/list-fan-zones.md)
- [Create a Fan Zone](https://developer.dizplai.com/api-reference/messaging-api/create-a-fan-zone.md): Created hidden unless you send status scheduled or live, so fans see it only once it's made live. Proxied by DizCore for clients; called directly by the console.
- [Get a Fan Zone](https://developer.dizplai.com/api-reference/messaging-api/get-a-fan-zone.md)
- [Update a Fan Zone or change its status](https://developer.dizplai.com/api-reference/messaging-api/update-a-fan-zone-or-change-its-status.md): Send only the fields to change, or a new status. An invalid status transition answers 400.
- [Upload a fan's voice note or photo](https://developer.dizplai.com/api-reference/messaging-api/upload-a-fans-voice-note-or-photo.md): DizCore only, on the private API. DizCore passes the fan's request through unchanged, with the fan's token from the client's own login in x-dizplai-fan-token, and never stores, caches or logs message text. DX checks the token and works out the fan itself. Our own hubs use the Fan API instead. The fi…
- [Send a fan's message](https://developer.dizplai.com/api-reference/messaging-api/send-a-fans-message.md): DizCore only, on the private API. DizCore passes the fan's request through unchanged, with the fan's token from the client's own login in x-dizplai-fan-token, and never stores, caches or logs message text. DX checks the token and works out the fan itself. Our own hubs use the Fan API instead. Text,…
- [See what happened to a fan's messages](https://developer.dizplai.com/api-reference/messaging-api/see-what-happened-to-a-fans-messages.md): DizCore only, on the private API. DizCore passes the fan's request through unchanged, with the fan's token from the client's own login in x-dizplai-fan-token, and never stores, caches or logs message text. DX checks the token and works out the fan itself. Our own hubs use the Fan API instead. The fa…
- [List sponsors](https://developer.dizplai.com/api-reference/sponsor-api/list-sponsors.md)
- [Create a sponsor widget](https://developer.dizplai.com/api-reference/sponsor-api/create-a-sponsor-widget.md): Created hidden unless you send status scheduled or live, so fans see it only once it's made live. Proxied by DizCore for clients; called directly by the console.
- [Get a sponsor widget](https://developer.dizplai.com/api-reference/sponsor-api/get-a-sponsor-widget.md)
- [Update a sponsor widget or change its status](https://developer.dizplai.com/api-reference/sponsor-api/update-a-sponsor-widget-or-change-its-status.md): Send only the fields to change, or a new status. An invalid status transition answers 400.
- [List quizs](https://developer.dizplai.com/api-reference/quiz-api/list-quizs.md)
- [Create a quiz](https://developer.dizplai.com/api-reference/quiz-api/create-a-quiz.md): Planned. DizCore will pass client calls through once the quiz body is agreed with Tom; until then only the console calls this route. Created hidden unless you send status scheduled or live, so fans see it only once it's made live.
- [Get a quiz with its results](https://developer.dizplai.com/api-reference/quiz-api/get-a-quiz-with-its-results.md)
- [Update a quiz or change its status](https://developer.dizplai.com/api-reference/quiz-api/update-a-quiz-or-change-its-status.md): Planned. DizCore will pass client calls through once the quiz body is agreed with Tom; until then only the console calls this route. Send only the fields to change, or a new status. An invalid status transition answers 400. Mark a closed quiz with status settled: its answers then appear on the item.
- [Get a quiz's results](https://developer.dizplai.com/api-reference/quiz-api/get-a-quizs-results.md): All of its results, whatever results_visibility says, from the fan side's full results document, cached for one second. For consoles and overlays: poll every second while it's live.
- [Cast a fan's vote](https://developer.dizplai.com/api-reference/quiz-api/cast-a-fans-vote.md): Planned. DizCore will forward client fan apps' quiz votes once the quiz body is agreed with Tom; until then nothing calls this route.
- [Pull every document changed since a time, for catch-up](https://developer.dizplai.com/api-reference/push-feed/pull-every-document-changed-since-a-time-for-catch-up.md)
- [Pull an experience's latest document, for recovery](https://developer.dizplai.com/api-reference/push-feed/pull-an-experiences-latest-document-for-recovery.md)
- [Reports and metrics](https://developer.dizplai.com/data/reports-and-metrics.md): What each number in a client's reports means, and how it's counted. Internal.
- [Get counts grouped by experience, widget, widget type, hub, matchday or link](https://developer.dizplai.com/api-reference/reports/get-counts-grouped-by-experience-widget-widget-type-hub-matchday-or-link.md): Reports across a client's experiences, widgets, matchdays, hubs and links. Group by `widget` for the console's per-widget tables, by `widgetType` for participation by format (polls, predictors and so on), and by `link` to see how each QR code or short link performed: clicks, then visits, participati…
- [List a client's short links and QR codes](https://developer.dizplai.com/api-reference/links/list-a-clients-short-links-and-qr-codes.md): Each link the client's team created in the console, with where it's used and how often it was scanned or tapped.
- [List a client's exports](https://developer.dizplai.com/api-reference/exports/list-a-clients-exports.md): Every export for the client, newest first, with who asked for it, for the back office's export history.
- [Start a fan-level export](https://developer.dizplai.com/api-reference/exports/start-a-fan-level-export.md): Consented fans only. Runs in the background and is audited. Poll the export for its status.
- [Get an export's status and download link](https://developer.dizplai.com/api-reference/exports/get-an-exports-status-and-download-link.md)
- [Erase a fan who signs in with a client's own login](https://developer.dizplai.com/api-reference/erasure/erase-a-fan-who-signs-in-with-a-clients-own-login.md): For fans who sign in with a client's own login. The client, as data controller, tells Dizplai to erase the fan, through Dizplai support for now; a client-facing route is an open question. It completes within 30 days. Fans with a Dizplai account erase themselves in the Fan API instead.
- [Signing in on a hub](https://developer.dizplai.com/fan/authentication.md): Who the fan is on every Fan API call, the hub's publishable key, and what happens when a session fails.
- [Errors and retries](https://developer.dizplai.com/fan/errors-and-retries.md): The Fan API's error shape, stable error codes, retries and limits.
- [Check the fan meets the minimum age (proposed)](https://developer.dizplai.com/api-reference/sign-in/check-the-fan-meets-the-minimum-age-proposed.md): Shown before the fan chooses email or Google. Below the minimum age for the fan's country nothing is stored and no account can be created. Proposed, pending legal review.
- [Sign up with email and password](https://developer.dizplai.com/api-reference/sign-in/sign-up-with-email-and-password.md)
- [Confirm the verification code](https://developer.dizplai.com/api-reference/sign-in/confirm-the-verification-code.md)
- [Send the verification code again](https://developer.dizplai.com/api-reference/sign-in/send-the-verification-code-again.md)
- [Start a password reset](https://developer.dizplai.com/api-reference/sign-in/start-a-password-reset.md)
- [Set a new password with the reset code](https://developer.dizplai.com/api-reference/sign-in/set-a-new-password-with-the-reset-code.md)
- [Sign in with email and password](https://developer.dizplai.com/api-reference/sign-in/sign-in-with-email-and-password.md)
- [Start signing in with Google, Apple, Facebook or the client's own login](https://developer.dizplai.com/api-reference/sign-in/start-signing-in-with-google-apple-facebook-or-the-clients-own-login.md)
- [Finish signing up after Google, Apple or Facebook](https://developer.dizplai.com/api-reference/sign-in/finish-signing-up-after-google-apple-or-facebook.md): For a fan whose first sign-in with Google, Apple or Facebook has just created an account. The hub asks for the date of birth and the consents, then calls this. Below the minimum age for the fan's country, the new account is deleted at once and nothing is kept. Not used for the client's own login, wh…
- [Start an anonymous session](https://developer.dizplai.com/api-reference/sign-in/start-an-anonymous-session.md): After the silent bot check, which the hub runs automatically. The session ID is issued by us, never chosen by the client.
- [Renew the session](https://developer.dizplai.com/api-reference/sign-in/renew-the-session.md): The hub calls this when a call returns 401, then retries that call once. It renews the session from the sign-in cookies set at sign-in, and normally runs before the session expires, so fans rarely see a 401. If the fan's sign-in has ended, it returns 401 with code `session_expired`, and the hub asks…
- [Sign out](https://developer.dizplai.com/api-reference/sign-in/sign-out.md): The browser sends the fan's session itself.
- [List live and upcoming experiences](https://developer.dizplai.com/api-reference/experiences/list-live-and-upcoming-experiences.md)
- [Get an experience with its widgets and their results](https://developer.dizplai.com/api-reference/experiences/get-an-experience-with-its-widgets-and-their-results.md): Every widget in display order, each shaped by its type and carrying its latest results where the type has them. This response is cached for a few seconds. For live results, poll each live widget's own route, which is cached for one second.
- [Get a poll and its results](https://developer.dizplai.com/api-reference/poll/get-a-poll-and-its-results.md): One flat object: the poll's display fields, state and version, with its latest results beside them: `totalBallots` and `final`, and `votes` and `percent` on each option. Results are left out while `resultsVisibility` is `hidden`, and while it is `after_close` and votes haven't stopped.
- [Vote in a poll](https://developer.dizplai.com/api-reference/poll/vote-in-a-poll.md): Send the fan's one choice. The request body, `--data` in the example, is that choice and nothing else: the `optionId` of one of the poll's options.
- [Get my vote in a poll](https://developer.dizplai.com/api-reference/poll/get-my-vote-in-a-poll.md): The signed-in fan's vote of record. Returns 404 until their first vote has been counted, usually within a second of voting. Never stored by a shared cache.
- [Get a rating and its results](https://developer.dizplai.com/api-reference/rating/get-a-rating-and-its-results.md): One flat object: the rating's display fields, state and version, with its latest results beside them: `totalBallots` and `final`, and `ratingCount`, `average` and `distribution` on each option. Results are left out while `resultsVisibility` is `hidden`, and while it is `after_close` and votes haven'…
- [Rate the players](https://developer.dizplai.com/api-reference/rating/rate-the-players.md): Send all of the fan's ratings in one request: a whole number from 1 to the widget's `maxRating` for each player, each player at most once. The request body, `--data` in the example, is the fan's choice and nothing else: a `value` for each player's `optionId`.
- [Get my ratings](https://developer.dizplai.com/api-reference/rating/get-my-ratings.md): The signed-in fan's vote of record. Returns 404 until their first vote has been counted, usually within a second of voting. Never stored by a shared cache.
- [Get a picker and its results](https://developer.dizplai.com/api-reference/picker/get-a-picker-and-its-results.md): One flat object: the picker's display fields, state and version, with its latest results beside them: `totalBallots` and `final`, and `votes` and `percent` on each option. Results are left out while `resultsVisibility` is `hidden`, and while it is `after_close` and votes haven't stopped.
- [Send my pick](https://developer.dizplai.com/api-reference/picker/send-my-pick.md): The hub runs the head-to-head rounds and sends only the fan's final pick. The request body, `--data` in the example, is the fan's choice and nothing else: the `optionId` the fan picked.
- [Get my pick](https://developer.dizplai.com/api-reference/picker/get-my-pick.md): The signed-in fan's vote of record. Returns 404 until their first vote has been counted, usually within a second of voting. Never stored by a shared cache.
- [Get a predictor and its results](https://developer.dizplai.com/api-reference/predictor/get-a-predictor-and-its-results.md): One flat object: the predictor's display fields, state and version, with its latest results beside them: `totalBallots`, `final` and `predictions`, every predicted score with its `votes`. Results are left out while `resultsVisibility` is `hidden`, and while it is `after_close` and votes haven't stop…
- [Predict the score](https://developer.dizplai.com/api-reference/predictor/predict-the-score.md): Votes stop at the widget's `locksAt`, usually kick-off. After that the widget is `locked`, and a vote returns 409 `widget_not_open`. The request body, `--data` in the example, is the fan's choice and nothing else: the score the fan predicts for each team.
- [Get my prediction and how I did](https://developer.dizplai.com/api-reference/predictor/get-my-prediction-and-how-i-did.md): The signed-in fan's vote of record. Returns 404 until their first vote has been counted, usually within a second of voting. Never stored by a shared cache. Once the predictor is settled, `outcome` shows how the fan did.
- [Get a line-up and its results](https://developer.dizplai.com/api-reference/line-up/get-a-line-up-and-its-results.md): One flat object: the line-up's display fields, state and version, with its latest results beside them: `totalBallots`, `final`, `positions`, and votes on each formation when fans choose it. Results are left out while `resultsVisibility` is `hidden`, and while it is `after_close` and votes haven't st…
- [Send my line-up](https://developer.dizplai.com/api-reference/line-up/send-my-line-up.md): The formation and every position are checked against the widget, repeated positions included. The request body, `--data` in the example, is the fan's choice and nothing else: the formation, and a player for each of its positions.
- [Get my line-up](https://developer.dizplai.com/api-reference/line-up/get-my-line-up.md): The signed-in fan's vote of record. Returns 404 until their first vote has been counted, usually within a second of voting. Never stored by a shared cache.
- [Get a Fan Zone](https://developer.dizplai.com/api-reference/messaging/get-a-fan-zone.md): The Fan Zone's prompt, limits, state and version. A Fan Zone has no results: fans don't see each other's messages. Returns 404 if the widget isn't a Fan Zone, or isn't yours.
- [Upload a voice note or photo](https://developer.dizplai.com/api-reference/messaging/upload-a-voice-note-or-photo.md): The first step of a voice note or photo message, for signed-in fans only. Say what you'll upload; DX checks the Fan Zone takes that kind, the type and size, and the fan's allowance, and returns a presigned S3 PUT URL straight to its storage, signed for exactly that type and size. PUT the file there…
- [Send a Fan Zone message](https://developer.dizplai.com/api-reference/messaging/send-a-fan-zone-message.md): Text, a voice note or a photo, as the Fan Zone's `kinds` allow. For a voice note or photo, upload it first with `POST /messaging/{fanZoneId}/uploads`, then send its `uploadId` here; voice notes and photos are for signed-in fans only. Returns 202 with the message's ID. The client's team reviews it, a…
- [Get a sponsor widget](https://developer.dizplai.com/api-reference/sponsor/get-a-sponsor-widget.md): The sponsor's category and slides. Shown for as long as its experience is published: it takes no votes and has no results. Returns 404 if the widget isn't a sponsor widget, or isn't yours.
- [Get a quiz and its results (planned)](https://developer.dizplai.com/api-reference/quiz/get-a-quiz-and-its-results-planned.md): One flat object: the quiz's display fields, state and version, with its latest results beside them: `totalBallots`, `final`, votes on each question's options, and `scoreDistribution` once it's marked. Results are left out while `resultsVisibility` is `hidden`, and while it is `after_close` and votes…
- [Answer a quiz (planned)](https://developer.dizplai.com/api-reference/quiz/answer-a-quiz-planned.md): Send all of the fan's answers in one request. The request body, `--data` in the example, is the fan's choice and nothing else: an `optionId` for each `questionId`.
- [Get my answers and score (planned)](https://developer.dizplai.com/api-reference/quiz/get-my-answers-and-score-planned.md): The signed-in fan's vote of record. Returns 404 until their first vote has been counted, usually within a second of voting. Never stored by a shared cache. Once the quiz is marked, `outcome` shows how the fan did.
- [List the hub's leaderboards](https://developer.dizplai.com/api-reference/leaderboards/list-the-hubs-leaderboards.md): Every public leaderboard on this hub. An empty list means leaderboards are off.
- [Get a leaderboard's standings](https://developer.dizplai.com/api-reference/leaderboards/get-a-leaderboards-standings.md): The public top list, cached at the edge. No sign-in needed.
- [Get my rank and points](https://developer.dizplai.com/api-reference/leaderboards/get-my-rank-and-points.md): Returns 200 with a null rank before the fan has points on this board.
- [Get my profile](https://developer.dizplai.com/api-reference/me/get-my-profile.md): Signed-in fans only. An anonymous session gets 401 `unauthorised`, because it has no profile.
- [Update my display name or leaderboard visibility](https://developer.dizplai.com/api-reference/me/update-my-display-name-or-leaderboard-visibility.md)
- [Delete my account and data](https://developer.dizplai.com/api-reference/me/delete-my-account-and-data.md): For fans with a Dizplai account. Starts the erasure, which completes within 30 days. A fan signed in with a client's own login is erased on the client's instruction, as the data controller. How the client sends that instruction is still to be agreed.
- [See what happened to my messages](https://developer.dizplai.com/api-reference/me/see-what-happened-to-my-messages.md): Each message the fan sent, newest first: sent, approved, not approved or removed. A message that isn't approved, or is removed, comes with the reason in plain words (the statement of reasons).
- [Get my votes and points history](https://developer.dizplai.com/api-reference/me/get-my-votes-and-points-history.md)

## OpenAPI Specs

- [data.openapi](/dx/api-reference/data.openapi.yaml)
- [fan.openapi](/dx/api-reference/fan.openapi.yaml)
- [write-api.openapi](/dx/api-reference/write-api.openapi.yaml)


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