Played media history
Media that finished playing, most recent first, cursor-paginated the same way as /tts/history. Requires media:read.
/media/historyAuthorizationBearer token (tp_live_... or tpat_...) · headerrequiredA TipPage API key (tp_live_..., created in Dashboard → Settings → Developer) or an OAuth 2.0 access token (tpat_..., see the OAuth guide). Both carry the same scopes and are accepted on every endpoint.
limitintegerbeforestringCursor - an order_id from a previous page (next_cursor). Returns rows strictly older than it.
One page of history.
mediaHistoryMediaItem[]Show propertiesHide properties
HistoryMediaItemorder_idstringdonor_namestringmedia_urlstring<uri>media_start_timeintegervideo_titlestring | nullvideo_thumbnailstring<uri> | nullvideo_durationintegerplatformstringrequested_viastringis_replaybooleanqueued_atstring<date-time>played_atstring<date-time>has_morebooleannext_cursorstring | nullUnknown cursor.
errorstringrequiredHuman-readable message.
codestringMachine-readable code (e.g. missing_scope, not_in_queue).
Missing or invalid credential (missing_api_key / invalid_api_key, or invalid_token for an expired/revoked OAuth access token).
errorstringrequiredHuman-readable message.
codestringMachine-readable code (e.g. missing_scope, not_in_queue).
The key lacks the required scope (missing_scope).
errorstringrequiredHuman-readable message.
codestringMachine-readable code (e.g. missing_scope, not_in_queue).
required_scopestringRate limit exceeded - check the RateLimit-* headers.
errorstring