---
title: "POST /ListParticipantReplicas"
method: POST
path: "/ListParticipantReplicas"
---

# POST /ListParticipantReplicas

`POST /ListParticipantReplicas`

Lists all the replicas for a participant from a source stage.

## Request body

- object
  - `sourceStageArn` string, required — ARN of the stage where the participant is publishing.
  - `participantId` string, required — Participant ID of the publisher that has been replicated. This is assigned by IVS and returned by <a>CreateParticipantToken</a> or the <code>jti</code> (JWT ID) used to <a href="https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/getting-started-distribute-tokens.html#getting-started-distribute-tokens-self-signed">create a self signed token</a>.
  - `nextToken` string — The first participant to retrieve. This is used for pagination; see the <code>nextToken</code> response field.
  - `maxResults` integer — Maximum number of results to return. Default: 50.

## Response `200`

Success

- ListParticipantReplicasResponse
  - `replicas` ParticipantReplica[], required — List of all participant replicas.
    - `sourceStageArn` string, required — ARN of the stage from which this participant is replicated.
    - `participantId` string, required — Participant ID of the publisher that will be replicated. This is assigned by IVS and returned by <a>CreateParticipantToken</a> or the <code>jti</code> (JWT ID) used to <a href="https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/getting-started-distribute-tokens.html#getting-started-distribute-tokens-self-signed"> create a self signed token</a>.
    - `sourceSessionId` string, required — ID of the session within the source stage.
    - `destinationStageArn` string, required — ARN of the stage where the participant is replicated.
    - `destinationSessionId` string, required — ID of the session within the destination stage.
    - `replicationState` 'ACTIVE' | 'STOPPED', required — Replica’s current replication state.
  - `nextToken` string — If there are more participants than <code>maxResults</code>, use <code>nextToken</code> in the request to get the next set.

## Other responses

- `480` — ValidationException
- `481` — AccessDeniedException

---

[API](https://skmtc.net/aws/apis/ivs-realtime.md) · [All operations](https://skmtc.net/aws/apis/ivs-realtime/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/ivs-realtime/revisions/f8857274a50f/schema)