History

get

Return song playback history items for a given station.

Authorizations

Path parameters

station_idany ofRequired

integer · int64Optional

or

string · stringOptional

Query parameters

startstringOptional

The start date for records, in PHP-supported date/time format. (https://www.php.net/manual/en/datetime.formats.php)

endstringOptional

The end date for records, in PHP-supported date/time format. (https://www.php.net/manual/en/datetime.formats.php)

Responses

200

Success

application/json

Responseall of[]

403

Access denied.

application/json

404

Record not found.

application/json

500

A generic exception has occurred.

application/json

get

HTTPcURLJavaScriptPython

GET /api/station/{station_id}/history HTTP/1.1
Host: listen.dovafm.xyz
X-API-Key: YOUR_API_KEY
Accept: */*

[
  {
    "sh_id": 1,
    "played_at": 1609480800,
    "duration": 180,
    "playlist": "Top 100",
    "streamer": "Test DJ",
    "is_request": true,
    "song": {
      "text": "Chet Porter - Aluko River",
      "artist": "Chet Porter",
      "title": "Aluko River",
      "album": "Moving Castle",
      "genre": "Rock",
      "isrc": "US28E1600021",
      "lyrics": "",
      "id": "9f33bbc912c19603e51be8e0987d076b",
      "art": "https://picsum.photos/1200/1200",
      "custom_fields": [
        "custom_field_value"
      ]
    },
    "listeners_start": 94,
    "listeners_end": 105,
    "delta_total": 11,
    "is_visible": true
  }
]