Skip to main content
GET
List the fan's messages

Authorizations

x-api-key
string
header
required

Your organisation's API key, supplied by Dizplai. Send it on every request. It isn't a secret, so it can ship in your app: what a fan does is protected by the fan's token.

Authorization
string
header
required

The fan's token from your own login, sent as Authorization: Bearer <token>: a signed-in fan's or a guest's. Dizplai checks it against your login's details, agreed when you're set up, and a guest's token carries the guest claim agreed at the same time. Needed to vote, upload, send a message, and read the fan's own vote or messages.

Path Parameters

fan_voice_id
string<uuid>
required

The Fan Voice's ID, from a list of experiences or Fan Voices. A Fan Voice's ID, a UUID.

Example:

"0192fa7b-a1a5-7ae6-8820-782ce84e0f49"

Query Parameters

after
string

Where the next page starts, the next value from the previous page. Leave it out for the first page.

limit
integer
default:50

How many items a page holds, 1 to 100. 50 by default.

Required range: 1 <= x <= 100

Response

The fan's messages, newest first, each with its status. A message that isn't approved, or is removed, comes with the reason; fans can't ask for a review. Not cached, as the answer belongs to one fan.

items
object[]
required

The fan's messages, newest first.

next
string | null
required

Pass as after for the next page. Null on the last page.