Batch live-stream status lookup

curl --request POST \
  --url https://teambattles.gg/api/v1/streams/live-status \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "userIds": [
    "<string>"
  ]
}
'

{
  "statuses": [
    {
      "id": "<string>",
      "isLive": true,
      "platforms": []
    }
  ],
  "count": 4503599627370495,
  "timestamp": "<string>"
}

Streaming

Batch live-stream status lookup

Filtered read returning compact live status for a batch of users (POST is used only to carry the id list; no data is written). Send a body of 1 - 50 Convex user IDs; duplicates are ignored and over-50 is rejected. Each response row is and does not include the primaryStream detail returned by GET /users//stream. Users that do not exist, are banned, or whose profile hides stream status from the caller are omitted from the response (the batch never reveals which case applied or that a hidden user exists), so count may be less than the number of IDs sent. Unlike the single-user stream endpoint, IDs are matched by user ID only; usernames are not resolved. No pagination and no guaranteed ordering. Requires stream.read.

POST

streams

live-status

curl --request POST \
  --url https://teambattles.gg/api/v1/streams/live-status \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "userIds": [
    "<string>"
  ]
}
'

{
  "statuses": [
    {
      "id": "<string>",
      "isLive": true,
      "platforms": []
    }
  ],
  "count": 4503599627370495,
  "timestamp": "<string>"
}

Authorizations

Authorization

string

header

required

Send your API key as: Authorization: Bearer tb_

Body

application/json

Batch live-status request body.

userIds

string[]

required

User IDs to look up (1-50).

Required array length: 1 - 50 elements

Response

Per-user live status for the visible subset of requested users.

Batch live-status results plus a response timestamp. Users not visible to the caller are omitted.

statuses

object[]

required

Show child attributes

count

integer

required

Required range: 0 <= x <= 9007199254740991

timestamp

string

required

ISO 8601 timestamp.

Get a user's live-stream status Get Channel Badges