ListenerRequest
A record somebody asked the station to play, and what became of it
Attributes (15)
| Attribute | Type | Required | Description |
|---|---|---|---|
id | string | Yes | |
trackId | string | No | The record in the station's library, so it can be asked for again with POST /requests. Absent on a refusal answered before a provider's record was taken in |
status | RequestStatus | Yes | waiting for an operator to approve it, pending while its audio is fetched or a place is found for it, queued in the running order, aired once heard, declined or expired when it never will be |
title | string | Yes | The record, as it was called when it was asked for |
artist | string | Yes | |
requesterName | string | Yes | Who asked, by the name their account or chat platform gave |
source | RequestSource | Yes | Whether it came from an app or a chat platform |
createdAt | string | Yes | When it was asked for |
reason | string | No | Why it was declined or expired, in the station's words or an operator's |
airedAt | string | No | When it aired |
dedicateTo | string | No | Who the listener dedicated it to |
message | string | No | What the listener asked to have said with it, in their own words |
fromParty | boolean | No | True when a guest at a party asked for it, through the party pass. Absent otherwise |
overrulable | boolean | No | True on a declined request whoever asked may still insist on, with POST /requests/{id}/insist: the station turned it down for its own taste (aired lately, a cooldown, a dislike, the period, a length) rather than a rule nobody overrules. Absent otherwise, and once it has been insisted on |
insisted | boolean | No | True when whoever asked insisted on it after the station turned it down, so the station's own taste was overruled. Absent otherwise |