Logo

Docs

Stations

Station Models

The station resource types used across the OpenMusic API.

BaseStation

Minimal station resource shape used for view=minimal and nested relationships.

interface BaseStation extends ResourceBase {
  type: "stations";
  relationships?: {
    tracks?: (Song | BaseSong)[];
  };
}

Station

Full station resource returned when attributes are requested; extends BaseStation.

interface Station extends BaseStation {
  attributes: StationAttributes;
}

StationAttributes

Full metadata fields attached to Station.

interface StationAttributes {
  name: string;
  seed: StationSeed;
  description: string | null;
  artwork_url: string | null;
  genres: string[];
}

StationSeed

Describes how the station was generated (artist, genre, or popular).

type StationSeed =
  | { kind: "artist"; artist: BaseArtist }
  | { kind: "genre"; genre: string }
  | { kind: "popular" };

On this page