# Get participant state in Amazon Connect Agent Workspace
<a name="3P-apps-contact-requests-getparticipantstate"></a>

Retrieves the current state of a specific participant.

 **Signature** 

```
getParticipantState(participantId: string): Promise<ParticipantState>
```

 **Usage** 

```
const state = await contactClient.getParticipantState("participant-456");
if (state.value === "connected") {
    console.log("Participant is connected");
} else if (state.value === "hold") {
    console.log("Participant is on hold");
}
```

 **Input** 


|  **Parameter**  |  **Type**  |  **Description**  | 
| --- | --- | --- | 
| participantId Required | string | The unique identifier for the participant | 

 **Output - ParticipantState** 

The ParticipantState type can be:
+ \$1 value: ParticipantStateType \$1 where ParticipantStateType includes: connecting, connected, hold, disconnected, rejected, silent\$1monitor, barge
+ \$1 value: "other"; actual: string \$1 for unknown states

 **Permissions required:** 

```
*
```