Skip to content

Radio

Read the latest or a specific verified shared Spotify mix

GET /api/radio/editions.json

Markdown · Authoritative OpenAPI

Request policy

Operation
getRadioEdition
Access
anonymous
Automatic retries
None
Redirects
Returned to the caller without following
Request body limit
No request body
Pagination
No collection iterator

Parameters

id string (uuid)

Responses

200

Verified edition, or null if none is available

application/json

object

Schema details

edition object required

Schema details

object

Schema details

id string required (uuid)

title string required

description string required

date string required (date)

publishedAt string required (date-time)

trackCount number required

spotifyUrl string required

tracks object[] required

Schema details

object

Schema details

canonicalId string required

title string required

artist string required

spotifyUri string required

itemPath string required

unknown

304

Not Modified

400

Invalid edition UUID

Examples

Examples use synthetic fixture values. Replace fixture identifiers with public IDs returned by the service. Request bodies and precise locations are transient; keep them out of logs.

curl

curl --fail-with-body --max-time 30 --max-filesize 16777216 --request GET 'https://irvinebroque.com/api/radio/editions.json' --header 'Accept: application/json'

TypeScript

import { PublicApi } from '@irvinebroque/public-api';
const api = new PublicApi();
const result = await api.radio.editions({});
console.log(result.status, result.headers.get('content-type')); // Keep transient capabilities in memory.

CLI

irvinebroque radio editions

The SDK preserves status, headers, and the server envelope. A 304 has no fresh body. Errors retain structured problem details; ordinary error messages omit response details. Responses are limited to 16 MiB and requests time out after 30 seconds by default.