Connections

List past connections

GET/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

  • linestring

    The line's username, exactly.

  • orderingstring

    Which field to use when ordering the results.

  • pageinteger

    A page number within the paginated result set.

  • page_sizeinteger

    Number of results to return per page.

  • scopestring

    Whose 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"

  • searchstring

    Part of the line, what was watched, the server or the address.

  • serverstring

    The server's name, exactly.

  • sincestring (date-time)

    Started at or after.

  • streamstring

    The stream's name, exactly.

  • untilstring (date-time)

    Started before.

Response

200 OK

  • countintegerrequired
  • nextstring (uri)can be null
  • previousstring (uri)can be null
  • resultsobject[]required
    • session_idstringrequired
    • linestringrequiredread-only
    • line_idstring (uuid)requiredread-only
    • ownerstringrequiredread-only

      Username of the account that created the line; empty when none did.

    • groupsstring[]requiredread-only

      That account's groups, e.g. Reseller.

    • stream_namestringrequiredread-only
    • kindstringrequiredread-only
    • titlestringrequiredread-only
    • serverstringrequiredread-onlycan be null

      The server the viewer was sent to.

    • ipstringrequiredread-only
    • playerstringrequiredread-onlycan be null
    • country_codestringrequiredread-onlycan be null
    • ispstringrequiredread-onlycan be null
    • citystringrequiredread-onlycan be null
    • outputstringrequiredread-only
    • restreamerbooleanrequiredread-only
    • restreamer_reasonsstring[]requiredread-only
    • datacenterbooleanrequiredread-only
    • vpnbooleanrequiredread-only
    • torbooleanrequiredread-only
    • started_atstring (date-time)requiredread-only
    • last_heartbeatstring (date-time)requiredread-only
    • ended_atstring (date-time)can be null
    • duration_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.

What each error means