---
title: "Get a list of livestream segments for a user"
method: GET
path: "/xrpc/place.stream.live.getLiveUsers"
tags: ["place.stream.live"]
---

# Get a list of livestream segments for a user

`GET /xrpc/place.stream.live.getLiveUsers`

## Query parameters

- `limit` integer
- `before` string, date-time

## Response `200`

Success

- object
  - `streams` PlaceStreamLivestreamLivestreamView[]
    - `uri` string, uri, required
    - `cid` string, cid, required
    - `author` AppBskyActorDefsProfileViewBasic, required
      - `did` string, did, required
      - `handle` string, handle, required
      - `displayName` string
      - `avatar` string, uri
      - `associated` AppBskyActorDefsProfileAssociated
        - `lists` integer
        - `feedgens` integer
        - `starterPacks` integer
        - `labeler` boolean
        - `chat` AppBskyActorDefsProfileAssociatedChat
          - `allowIncoming` string, required
      - `viewer` AppBskyActorDefsViewerState — Metadata about the requesting account's relationship with the subject account. Only has meaningful content for authed requests.
        - `muted` boolean
        - `mutedByList` AppBskyGraphDefsListViewBasic
          - `uri` string, uri, required
          - `cid` string, cid, required
          - `name` string, required
          - `purpose` string, required
          - `avatar` string, uri
          - `listItemCount` integer
          - `labels` ComAtprotoLabelDefsLabel[]
            - `ver` integer — The AT Protocol version of the label object.
            - `src` string, did, required — DID of the actor who created this label.
            - `uri` string, uri, required — AT URI of the record, repository (account), or other resource that this label applies to.
            - `cid` string, cid — Optionally, CID specifying the specific version of 'uri' resource this label applies to.
            - `val` string, required — The short string name of the value or type of this label.
            - `neg` boolean — If true, this is a negation label, overwriting a previous label.
            - `cts` string, date-time, required — Timestamp when this label was created.
            - `exp` string, date-time — Timestamp at which this label expires (no longer applies).
            - `sig` string, byte — Signature of dag-cbor encoded label.
          - `viewer` AppBskyGraphDefsListViewerState
            - `muted` boolean
            - `blocked` string, uri
          - `indexedAt` string, date-time
        - `blockedBy` boolean
        - `blocking` string, uri
        - `blockingByList` AppBskyGraphDefsListViewBasic
          - `uri` string, uri, required
          - `cid` string, cid, required
          - `name` string, required
          - `purpose` string, required
          - `avatar` string, uri
          - `listItemCount` integer
          - `labels` ComAtprotoLabelDefsLabel[]
            - `ver` integer — The AT Protocol version of the label object.
            - `src` string, did, required — DID of the actor who created this label.
            - `uri` string, uri, required — AT URI of the record, repository (account), or other resource that this label applies to.
            - `cid` string, cid — Optionally, CID specifying the specific version of 'uri' resource this label applies to.
            - `val` string, required — The short string name of the value or type of this label.
            - `neg` boolean — If true, this is a negation label, overwriting a previous label.
            - `cts` string, date-time, required — Timestamp when this label was created.
            - `exp` string, date-time — Timestamp at which this label expires (no longer applies).
            - `sig` string, byte — Signature of dag-cbor encoded label.
          - `viewer` AppBskyGraphDefsListViewerState
            - `muted` boolean
            - `blocked` string, uri
          - `indexedAt` string, date-time
        - `following` string, uri
        - `followedBy` string, uri
        - `knownFollowers` AppBskyActorDefsKnownFollowers — The subject's followers whom you also follow
          - `count` integer, required
          - `followers` AppBskyActorDefsProfileViewBasic[], required
      - `labels` ComAtprotoLabelDefsLabel[]
        - `ver` integer — The AT Protocol version of the label object.
        - `src` string, did, required — DID of the actor who created this label.
        - `uri` string, uri, required — AT URI of the record, repository (account), or other resource that this label applies to.
        - `cid` string, cid — Optionally, CID specifying the specific version of 'uri' resource this label applies to.
        - `val` string, required — The short string name of the value or type of this label.
        - `neg` boolean — If true, this is a negation label, overwriting a previous label.
        - `cts` string, date-time, required — Timestamp when this label was created.
        - `exp` string, date-time — Timestamp at which this label expires (no longer applies).
        - `sig` string, byte — Signature of dag-cbor encoded label.
      - `createdAt` string, date-time
      - `verification` AppBskyActorDefsVerificationState — Represents the verification information about the user this object is attached to.
        - `verifications` AppBskyActorDefsVerificationView[], required — All verifications issued by trusted verifiers on behalf of this user. Verifications by untrusted verifiers are not included.
          - `issuer` string, did, required — The user who issued this verification.
          - `uri` string, uri, required — The AT-URI of the verification record.
          - `isValid` boolean, required — True if the verification passes validation, otherwise false.
          - `createdAt` string, date-time, required — Timestamp when the verification was created.
        - `verifiedStatus` string, required — The user's status as a verified account.
        - `trustedVerifierStatus` string, required — The user's status as a trusted verifier.
      - `status` AppBskyActorDefsStatusView
        - `status` string, required — The status for the account.
        - `record` unknown, required
        - `embed` AppBskyEmbedExternalView
          - `external` AppBskyEmbedExternalViewExternal, required
            - `uri` string, uri, required
            - `title` string, required
            - `description` string, required
            - `thumb` string, uri
        - `expiresAt` string, date-time — The date when this status will expire. The application might choose to no longer return the status after expiration.
        - `isActive` boolean — True if the status is not expired, false if it is expired. Only present if expiration was set.
    - `record` unknown, required
    - `indexedAt` string, date-time, required
    - `viewerCount` PlaceStreamLivestreamViewerCount
      - `count` integer, required

## Changes

- **2026-04-20** `3353f5f6354a` — 1 info
  - endpoint added
- **2026-04-20** `f6e6f5a5a3cb` — 1 breaking
  - api path removed without deprecation
- **2026-01-21** `b21cd7605630` — 19 warning
  - removed the optional property `streams/items/author/associated/activitySubscription` from the response with the `200` status
  - removed the optional property `streams/items/author/associated/chat/allowGroupInvites` from the response with the `200` status
  - removed the optional property `streams/items/author/associated/germ` from the response with the `200` status
  - removed the optional property `streams/items/author/debug` from the response with the `200` status
  - …15 more

[Change history](https://skmtc.dev/streamplace/apis/generated-lexicon-api-schema/changes/xrpc/place.stream.live.getLiveUsers/get.md)

---

[API](https://skmtc.dev/streamplace/apis/generated-lexicon-api-schema.md) · [All operations](https://skmtc.dev/streamplace/apis/generated-lexicon-api-schema/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/streamplace/generated-lexicon-api-schema/revisions/0eb3e511bec2/schema)