DovaFM Documentation
WebsiteAdd Discord Bot
  • Welcome to the DovaFM Documentation!
  • DovaFM Stream
    • Embed Widgets
    • Public Pages
    • Radio & Playlist Streams
  • DovaFM API
    • Now Playing
    • Stations
      • General
      • Broadcasting
      • Song Requests
      • Service Control
      • History
      • HLS Streams
      • Listeners
      • Schedules
      • Media
      • Mount Points
      • Playlists
      • Podcasts
      • Queue
      • Remote Relays
      • SFTP Users
      • Streamers/DJs
      • Web Hooks
    • Administration
      • Custom Fields
      • Users
      • Relays
      • Roles
      • Settings
      • Stations
      • Storage Locations
      • CPU Status
    • Miscellaneous
      • Status
      • Time
  • DovaFM Discord Bot
    • Information
    • Commands
  • DovaFM Staff
    • Staff Members
Powered by GitBook
On this page
  1. DovaFM API
  2. Stations

Listeners

PreviousHLS StreamsNextSchedules

Last updated 7 months ago

get

Return detailed information about current listeners.

Authorizations
Path parameters
station_idany ofRequired
integer · int64Optional
or
string · stringOptional
Responses
200
Success
application/json
403
Access denied.
application/json
404
Record not found.
application/json
500
A generic exception has occurred.
application/json
get
GET /api/station/{station_id}/listeners HTTP/1.1
Host: listen.dovafm.xyz
X-API-Key: YOUR_API_KEY
Accept: */*
[
  {
    "ip": "127.0.0.1",
    "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/59.0.3071.86 Safari/537.36",
    "hash": "",
    "mount_is_local": false,
    "mount_name": "/radio.mp3",
    "connected_on": 1609480800,
    "connected_until": 1609480800,
    "connected_time": 30,
    "device": {
      "is_browser": true,
      "is_mobile": true,
      "is_bot": true,
      "client": "Firefox 121.0, Windows",
      "browser_family": "Firefox",
      "os_family": "Windows"
    },
    "location": {
      "city": "Austin",
      "region": "Texas",
      "country": "United States",
      "description": "Austin, Texas, US",
      "lat": "30.000000",
      "lon": "-97.000000"
    }
  }
]