Skip to main content

Session

The session object returned by POST /session. There is no session resource to fetch or delete afterwards; this reports whether the client can stream, who the client is, and the server's clock.

availablebooleanrequired

true when a streaming placement with at least one playable station was found for this client and country. When false, no music can be played and message explains why.

client_idstringrequired

The client's uuid. Pass this back on subsequent calls (as a client_id body property or query parameter) to keep play history, likes and skip limits attached to the same listener. If a client_id was passed to the call, then this entry will match that value.

Example: FgT1_Yzvr_e05ANk2uCYdZi
timeintegerrequired

The server's current time as a Unix timestamp in seconds (not milliseconds).

Example: 1754265600
messagestring

Why streaming is unavailable. Present only when available is false.

Example: Sorry, there is no streaming music available for your client
Session
{
  "available": true,
  "client_id": "FgT1_Yzvr_e05ANk2uCYdZi",
  "time": 1754265600,
  "message": "Sorry, there is no streaming music available for your client"
}