# Return information about a single station.

`GET /station/{station_id}`

Authentication: no security requirement declared for this operation.

Parameters:

- `station_id` (path, unknown, required)
  Type: unknown
  
  anyOf:
    Type: integer, int64
  
    Type: string, string

Responses:

- 200: Success

Content type: application/json

Type: object

Schema: [Api_NowPlaying_Station](https://sourcey-azuracast.pages.dev/docs/api/models/api-nowplaying-station/index.md)

- `id` (required)
  Type: integer
  
  Station ID
  
  Example:
  
  ```json
  1
  ```

- `name` (required)
  Type: string
  
  Station name
  
  Example:
  
  ```json
  "AzuraTest Radio"
  ```

- `shortcode` (required)
  Type: string
  
  Station "short code", used for URL and folder paths
  
  Example:
  
  ```json
  "azuratest_radio"
  ```

- `description` (required)
  Type: string
  
  Station description
  
  Example:
  
  ```json
  "An AzuraCast station!"
  ```

- `frontend` (required)
  Type: string
  
  Which broadcasting software (frontend) the station uses
  
  Example:
  
  ```json
  "shoutcast2"
  ```

- `backend` (required)
  Type: string
  
  Which AutoDJ software (backend) the station uses
  
  Example:
  
  ```json
  "liquidsoap"
  ```

- `timezone` (required)
  Type: string
  
  The station's IANA time zone
  
  Example:
  
  ```json
  "America/Chicago"
  ```

- `listen_url` (required)
  Type: string
  
  The full URL to listen to the default mount of the station
  
  Example:
  
  ```json
  "http://localhost:8000/radio.mp3"
  ```

- `url` (required)
  Type: string; nullable
  
  The public URL of the station.
  
  Example:
  
  ```json
  "https://example.com/"
  ```

- `public_player_url` (required)
  Type: string
  
  The public player URL for the station.
  
  Example:
  
  ```json
  "https://example.com/public/example_station"
  ```

- `playlist_pls_url` (required)
  Type: string
  
  The playlist download URL in PLS format.
  
  Example:
  
  ```json
  "https://example.com/public/example_station/playlist.pls"
  ```

- `playlist_m3u_url` (required)
  Type: string
  
  The playlist download URL in M3U format.
  
  Example:
  
  ```json
  "https://example.com/public/example_station/playlist.m3u"
  ```

- `is_public` (required)
  Type: boolean
  
  If the station is public (i.e. should be shown in listings of all stations)
  
  Example:
  
  ```json
  true
  ```

- `requests_enabled` (required)
  Type: boolean
  
  If the station has song requests enabled.
  
  Example:
  
  ```json
  true
  ```

- `mounts` (required)
  Type: array
  
  Items:
    Reference: [Api_NowPlaying_StationMount](https://sourcey-azuracast.pages.dev/docs/api/models/api-nowplaying-stationmount/index.md); Type: object

- `remotes` (required)
  Type: array
  
  Items:
    Reference: [Api_NowPlaying_StationRemote](https://sourcey-azuracast.pages.dev/docs/api/models/api-nowplaying-stationremote/index.md); Type: object

- `hls_enabled` (required)
  Type: boolean
  
  If the station has HLS streaming enabled.
  
  Example:
  
  ```json
  true
  ```

- `hls_is_default` (required)
  Type: boolean
  
  If the HLS stream should be the default one for the station.
  
  Example:
  
  ```json
  true
  ```

- `hls_url` (required)
  Type: string; nullable
  
  The full URL to listen to the HLS stream for the station.
  
  Example:
  
  ```json
  "https://example.com/hls/azuratest_radio/live.m3u8"
  ```

- `hls_listeners` (required)
  Type: integer
  
  HLS Listeners
  
  Example:
  
  ```json
  1
  ```

- 404: Record not found.

Content type: application/json

Type: object

Schema: [Api_Error](https://sourcey-azuracast.pages.dev/docs/api/models/api-error/index.md)

- `code` (required)
  Type: integer
  
  The numeric code of the error.
  
  Example:
  
  ```json
  500
  ```

- `type` (required)
  Type: string
  
  The programmatic class of error.
  
  Example:
  
  ```json
  "NotLoggedInException"
  ```

- `message` (required)
  Type: string
  
  The text description of the error.
  
  Example:
  
  ```json
  "Error description."
  ```

- `formatted_message` (required)
  Type: string; nullable
  
  The HTML-formatted text description of the error.
  
  Example:
  
  ```json
  "<b>Error description.</b><br>Detailed error text."
  ```

- `extra_data` (required)
  Type: array
  
  Stack traces and other supplemental data.
  
  Items:
    Type: any

- `success` (required)
  Type: boolean
  
  Used for API calls that expect an \Entity\Api\Status type response.
  
  Example:
  
  ```json
  false
  ```

## Examples

### cURL

```bash
curl -X GET 'https://demo.azuracast.com/api/station/0'
```

### JavaScript

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

const data = await response.text();
```

### Python

```python
import requests

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