Connections

List live connections

GET/streams/connections/

read Read: looks, changes nothing. Scopes

Everyone watching now: one row per connection with the line, what it watches, the server, the address and where it comes from, newest first. Not paged. Rows of lines the caller may not manage are left out.

Query parameters

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

Response

200 OK

  • 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

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