Returns a list of stations.

GET

https://demo.azuracast.com/api/stations

curl -X GET 'https://demo.azuracast.com/api/stations'

const response = await fetch('https://demo.azuracast.com/api/stations', {
  method: 'GET',
});

const data = await response.text();

import requests

response = requests.get('https://demo.azuracast.com/api/stations')
print(response.text)

200

[
  {
    "id": 1,
    "name": "AzuraTest Radio",
    "shortcode": "azuratest_radio",
    "description": "An AzuraCast station!",
    "frontend": "shoutcast2",
    "backend": "liquidsoap",
    "timezone": "America/Chicago",
    "listen_url": "http://localhost:8000/radio.mp3",
    "url": "https://example.com/",
    "public_player_url": "https://example.com/public/example_station",
    "playlist_pls_url": "https://example.com/public/example_station/playlist.pls",
    "playlist_m3u_url": "https://example.com/public/example_station/playlist.m3u",
    "is_public": true,
    "requests_enabled": true,
    "mounts": [
      {
        "id": 1,
        "name": "/radio.mp3",
        "url": "http://localhost:8000/radio.mp3",
        "bitrate": 128,
        "format": "mp3",
        "listeners": {
          "total": 20,
          "unique": 15,
          "current": 20
        },
        "path": "/radio.mp3",
        "is_default": true
      }
    ],
    "remotes": [
      {
        "id": 1,
        "name": "/radio.mp3",
        "url": "http://localhost:8000/radio.mp3",
        "bitrate": 128,
        "format": "mp3",
        "listeners": {
          "total": 20,
          "unique": 15,
          "current": 20
        }
      }
    ],
    "hls_enabled": true,
    "hls_is_default": true,
    "hls_url": "https://example.com/hls/azuratest_radio/live.m3u8",
    "hls_listeners": 1
  }
]

Response

200OKArray<Api_NowPlaying_Station>

Success

Response fields application/json

Array<Api_NowPlaying_Station>

Show child attributes

idintegerrequired

Station ID

Example

namestringrequired

Station name

Example

AzuraTest Radio

shortcodestringrequired

Station “short code”, used for URL and folder paths

Example

azuratest_radio

descriptionstringrequired

Station description

Example

An AzuraCast station!

frontendstringrequired

Which broadcasting software (frontend) the station uses

Example

shoutcast2

backendstringrequired

Which AutoDJ software (backend) the station uses

Example

liquidsoap

timezonestringrequired

The station’s IANA time zone

Example

America/Chicago

listen_urlstringrequired

The full URL to listen to the default mount of the station

Example

http://localhost:8000/radio.mp3

urlstring | nullrequired

The public URL of the station.

Example

https://example.com/

public_player_urlstringrequired

The public player URL for the station.

Example

https://example.com/public/example_station

playlist_pls_urlstringrequired

The playlist download URL in PLS format.

Example

https://example.com/public/example_station/playlist.pls

playlist_m3u_urlstringrequired

The playlist download URL in M3U format.

Example

https://example.com/public/example_station/playlist.m3u

is_publicbooleanrequired

If the station is public (i.e. should be shown in listings of all stations)

Example

true

requests_enabledbooleanrequired

If the station has song requests enabled.

Example

true

mountsArray<Api_NowPlaying_StationMount>required

Show child attributes

idintegerrequired

Mount/Remote ID number.

Example

namestringrequired

Mount point name/URL

Example

/radio.mp3

urlstringrequired

Full listening URL specific to this mount

Example

http://localhost:8000/radio.mp3

bitrateinteger | nullrequired

Bitrate (kbps) of the broadcasted audio (if known)

Example

formatstring | nullrequired

Audio encoding format of broadcasted audio (if known)

Example

mp3

listenersApi_NowPlaying_Listenersrequired

Show child attributes

totalintegerrequired

Total non-unique current listeners

Example

uniqueintegerrequired

Total unique current listeners

Example

currentintegerrequired

Total non-unique current listeners (Legacy field, may be retired in the future.)

Example

pathstringrequired

The relative path that corresponds to this mount point

Example

/radio.mp3

is_defaultbooleanrequired

If the mount is the default mount for the parent station

Example

true

remotesArray<Api_NowPlaying_StationRemote>required

Show child attributes

idintegerrequired

Mount/Remote ID number.

Example

namestringrequired

Mount point name/URL

Example

/radio.mp3

urlstringrequired

Full listening URL specific to this mount

Example

http://localhost:8000/radio.mp3

bitrateinteger | nullrequired

Bitrate (kbps) of the broadcasted audio (if known)

Example

formatstring | nullrequired

Audio encoding format of broadcasted audio (if known)

Example

mp3

listenersApi_NowPlaying_Listenersrequired

Show child attributes

totalintegerrequired

Total non-unique current listeners

Example

uniqueintegerrequired

Total unique current listeners

Example

currentintegerrequired

Total non-unique current listeners (Legacy field, may be retired in the future.)

Example

hls_enabledbooleanrequired

If the station has HLS streaming enabled.

Example

true

hls_is_defaultbooleanrequired

If the HLS stream should be the default one for the station.

Example

true

hls_urlstring | nullrequired

The full URL to listen to the HLS stream for the station.

Example

https://example.com/hls/azuratest_radio/live.m3u8

hls_listenersintegerrequired

HLS Listeners

Example

Docs by Sourcey