Skip to main content
POST
Record listened time for an authorized playback. Use request setup for account headers.

Path

string
required
Song ID.

JSON body

string
required
Intent returned by playback authorization.
number
Cumulative nonnegative listened time in seconds. Required for Credits checkpoints.
boolean
Credits only: release the remaining playback hold when finished.

Response

USDC returns { success, result }. Credits returns { success: true, result: { billedWei, status: "credited" } }. Send the same funding and account headers as playback. /api/stream/{id}/checkpoint is an alias.