List past connections
/streams/activity/read Read: looks, changes nothing. Scopes
Connections that have ended, newest first, a page at a time (page_size up to 100). Rows of lines the caller may not manage are left out.
Query parameters
linestringThe line's username, exactly.
orderingstringWhich field to use when ordering the results.
pageintegerA page number within the paginated result set.
page_sizeintegerNumber of results to return per page.
scopestringWhose lines: the caller's own (
mine, the default for most), theirs and their resellers' (subtree), or every line (all, for accounts allowed to see them all).One of:
"all""mine""subtree"searchstringPart of the line, what was watched, the server or the address.
serverstringThe server's name, exactly.
sincestring (date-time)Started at or after.
streamstringThe stream's name, exactly.
untilstring (date-time)Started before.
Response
200 OK
countintegerrequirednextstring (uri)can be nullpreviousstring (uri)can be nullresultsobject[]requiredsession_idstringrequiredlinestringrequiredread-onlyline_idstring (uuid)requiredread-onlyownerstringrequiredread-onlyUsername of the account that created the line; empty when none did.
groupsstring[]requiredread-onlyThat account's groups, e.g. Reseller.
stream_namestringrequiredread-onlykindstringrequiredread-onlytitlestringrequiredread-onlyserverstringrequiredread-onlycan be nullThe server the viewer was sent to.
ipstringrequiredread-onlyplayerstringrequiredread-onlycan be nullcountry_codestringrequiredread-onlycan be nullispstringrequiredread-onlycan be nullcitystringrequiredread-onlycan be nulloutputstringrequiredread-onlyrestreamerbooleanrequiredread-onlyrestreamer_reasonsstring[]requiredread-onlydatacenterbooleanrequiredread-onlyvpnbooleanrequiredread-onlytorbooleanrequiredread-onlystarted_atstring (date-time)requiredread-onlylast_heartbeatstring (date-time)requiredread-onlyended_atstring (date-time)can be nullduration_secondsintegerrequiredread-onlycan be null
Errors
- 401 No credential, or one that is wrong, expired or revoked.
- 403 The account, or the key's or app's scopes, may not do this.
- 429 Slow down: wait the seconds in the Retry-After header, then try again.