# Retrieve details for a single station.
`GET /admin/station/{id}`
Authentication (security requirement alternatives):
```json
[
{
"ApiKey": []
}
]
```
- ApiKey: apiKey, header X-API-Key
Parameters:
- `id` (path, integer, int64, required) - ID
Type: integer, int64
Responses:
- 200: Success
Content type: application/json
Type: object
Schema: [Station](https://sourcey-azuracast.pages.dev/docs/api/models/station/index.md)
allOf:
Reference: [HasAutoIncrementId](https://sourcey-azuracast.pages.dev/docs/api/models/hasautoincrementid/index.md); Type: object
Type: object
- `name` (optional)
Type: string
The full display name of the station.
Example:
```json
"AzuraTest Radio"
```
- `short_name` (optional)
Type: string
The URL-friendly name for the station, typically auto-generated from the full station name.
Example:
```json
"azuratest_radio"
```
- `is_enabled` (optional)
Type: boolean
If set to 'false', prevents the station from broadcasting but leaves it in the database.
Example:
```json
true
```
- `frontend_type` (optional)
Reference: [FrontendAdapters](https://sourcey-azuracast.pages.dev/docs/api/models/frontendadapters/index.md); Type: string
enum: ["icecast","shoutcast2","rsas","remote"]
- `frontend_config` (optional)
Reference: [StationFrontendConfiguration](https://sourcey-azuracast.pages.dev/docs/api/models/stationfrontendconfiguration/index.md); Type: object
- `backend_type` (optional)
Reference: [BackendAdapters](https://sourcey-azuracast.pages.dev/docs/api/models/backendadapters/index.md); Type: string
enum: ["liquidsoap","none"]
- `backend_config` (optional)
Reference: [StationBackendConfiguration](https://sourcey-azuracast.pages.dev/docs/api/models/stationbackendconfiguration/index.md); Type: object
- `description` (optional)
Type: string; nullable
Example:
```json
"A sample radio station."
```
- `url` (optional)
Type: string; nullable
Example:
```json
"https://demo.azuracast.com/"
```
- `genre` (optional)
Type: string; nullable
Example:
```json
"Various"
```
- `radio_base_dir` (optional)
Type: string
Example:
```json
"/var/azuracast/stations/azuratest_radio"
```
- `enable_requests` (optional)
Type: boolean
Whether listeners can request songs to play on this station.
Example:
```json
true
```
- `request_delay` (optional)
Type: integer; nullable
Example:
```json
5
```
- `request_threshold` (optional)
Type: integer; nullable
Example:
```json
15
```
- `requests_only_via_playlists` (optional)
Type: boolean
Example:
```json
false
```
- `disconnect_deactivate_streamer` (optional)
Type: integer; nullable
Example:
```json
0
```
- `enable_streamers` (optional)
Type: boolean
Whether streamers are allowed to broadcast to this station at all.
Example:
```json
false
```
- `is_streamer_live` (optional)
Type: boolean
Whether a streamer is currently active on the station.
Example:
```json
false
```
- `enable_public_page` (optional)
Type: boolean
Whether this station's public pages (player, on-demand streaming, etc.) are visible to non-authenticated users.
Example:
```json
true
```
- `enable_public_api` (optional)
Type: boolean
Whether the public-facing API endpoints (now playing, art, etc.) are visible to non-authenticated users. Automatically enabled if 'enable_public_page' is true.
Example:
```json
true
```
- `enable_on_demand` (optional)
Type: boolean
Whether this station has a public 'on-demand' streaming and download page.
Example:
```json
true
```
- `enable_on_demand_download` (optional)
Type: boolean
Whether the 'on-demand' page offers download capability.
Example:
```json
true
```
- `enable_hls` (optional)
Type: boolean
Whether HLS streaming is enabled.
Example:
```json
true
```
- `api_history_items` (optional)
Type: integer
The number of 'last played' history items to show for a station in API responses.
Example:
```json
5
```
- `timezone` (optional)
Type: string
The time zone that station operations should take place in.
Example:
```json
"UTC"
```
- `max_bitrate` (optional)
Type: integer
The maximum bitrate at which a station may broadcast, in Kbps. 0 for unlimited
Example:
```json
128
```
- `max_mounts` (optional)
Type: integer
The maximum number of mount points the station can have, 0 for unlimited
Example:
```json
3
```
- `max_hls_streams` (optional)
Type: integer
The maximum number of HLS streams the station can have, 0 for unlimited
Example:
```json
3
```
- `branding_config` (optional)
Reference: [StationBrandingConfiguration](https://sourcey-azuracast.pages.dev/docs/api/models/stationbrandingconfiguration/index.md); Type: object
- 403: Access denied.
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
"Error description.
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
```
- 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
"Error description.
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
```
- 500: A generic exception has occurred.
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
"Error description.
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/admin/station/0' \
-H 'X-API-Key: YOUR_TOKEN'
```
### JavaScript
```javascript
const response = await fetch('https://demo.azuracast.com/api/admin/station/0', {
method: 'GET',
headers: {
'X-API-Key': 'YOUR_TOKEN',
},
});
const data = await response.text();
```
### Python
```python
import requests
response = requests.get(
'https://demo.azuracast.com/api/admin/station/0',
headers={
'X-API-Key': 'YOUR_TOKEN',
},
)
print(response.text)
```