---
title: "List Participants by Envelope ID"
method: GET
path: "/sign/envelopes/{envelopeID}/participants"
tags: ["Sign"]
---

# List Participants by Envelope ID

`GET /sign/envelopes/{envelopeID}/participants`

## Request

- Base URL: `https://api.gonitro.dev`
- URL: `https://api.gonitro.dev/sign/envelopes/{envelopeID}/participants`
- Auth: HTTP bearer

The **List Participant by Envelope ID** endpoint returns all participants associated with a specific envelope.
The request must include the envelope ID to ensure the complete set of participants is retrieved for the correct envelope.

## Path parameters

- `envelopeID` string, uuid, required

## Response `200`

List participants

- ParticipantList: #### Fields
  - `items` Participant[]: An array of participants associated with the package
    - `ID` string, uuid: The unique identifier of the participant
    - `email` string: The email address of the participant
    - `role` string: The role of the participant
    - `authentication` union: Participant authentication
      - AccessCode: Access code
        - `accessCode` string: Access code. It must contain between 4-32 characters.
        - `type` 'AccessCode'
      - SMS: SMS
        - `countryCode` string: Country code. It must start with `+` and be followed by 1-4 digits. For example +1, +55, +598
        - `phoneNumber` string: Phone number. Enter digits only, without a country code or formatting characters.
        - `type` 'SMS'
  - `total` integer: The total number of items available in the collection

## Other responses

- `401`: Unauthorized - Invalid or missing JWT token
- `404`: Envelope not found

---

[API](https://skmtc.dev/gonitro/apis/nitro-sign-public-api.md) - [All operations](https://skmtc.dev/gonitro/apis/nitro-sign-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gonitro/apis/nitro-sign-public-api/revisions/fc0d2e7e0460?raw)