Skip to main content

ListenerRequest

A record somebody asked the station to play, and what became of it

Attributes (15)
AttributeTypeRequiredDescription
idstringYes
trackIdstringNoThe 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
statusRequestStatusYeswaiting 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
titlestringYesThe record, as it was called when it was asked for
artiststringYes
requesterNamestringYesWho asked, by the name their account or chat platform gave
sourceRequestSourceYesWhether it came from an app or a chat platform
createdAtstringYesWhen it was asked for
reasonstringNoWhy it was declined or expired, in the station's words or an operator's
airedAtstringNoWhen it aired
dedicateTostringNoWho the listener dedicated it to
messagestringNoWhat the listener asked to have said with it, in their own words
fromPartybooleanNoTrue when a guest at a party asked for it, through the party pass. Absent otherwise
overrulablebooleanNoTrue 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
insistedbooleanNoTrue when whoever asked insisted on it after the station turned it down, so the station's own taste was overruled. Absent otherwise