---
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`

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.net/gonitro/apis/nitro-sign-public-api.md) · [All operations](https://skmtc.net/gonitro/apis/nitro-sign-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gonitro/nitro-sign-public-api/revisions/ed9efc6a8a47/schema)