> ## Documentation Index
> Fetch the complete documentation index at: https://developers.gonitro.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# List Participants by Envelope ID

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




## OpenAPI

````yaml https://api.gonitro.dev/openapi.json get /sign/envelopes/{envelopeID}/participants
openapi: 3.1.0
info:
  title: Nitro Sign Public API
  description: REST API for Nitro Sign
  version: '0.1'
servers:
  - url: https://api.gonitro.dev
security:
  - bearerAuth: []
paths:
  /sign/envelopes/{envelopeID}/participants:
    get:
      tags:
        - Sign
      summary: List Participants by Envelope ID
      description: >
        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.
      operationId: listParticipants
      parameters:
        - name: envelopeID
          in: path
          description: >-
            A unique UUIDv4 string that identifies the envelope in the Nitro
            system.
          required: true
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: List participants
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ParticipantList'
        '401':
          description: Unauthorized - Invalid or missing JWT token
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/UnauthorizedProblemDetail'
        '404':
          description: Envelope not found
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/NotFoundProblemDetail'
components:
  schemas:
    ParticipantList:
      type: object
      description: '#### Fields'
      properties:
        items:
          type: array
          description: An array of participants associated with the package
          items:
            $ref: '#/components/schemas/Participant'
        total:
          type: integer
          format: int32
          description: The total number of items available in the collection
    UnauthorizedProblemDetail:
      type: object
      description: Unauthorized error details
      example:
        type: >-
          https://developers.gonitro.com/docs/build-nitro/errors#401-unauthorized
        title: Unauthorized
        status: 401
        detail: Missing or invalid Authorization header
        instance: /sign/envelopes
      properties:
        type:
          type: string
          description: A URI reference that identifies the problem type
        title:
          type: string
          description: A short, human-readable summary of the problem type
        status:
          type: integer
          format: int32
          description: The HTTP status code
        detail:
          type: string
          description: A human-readable explanation specific to this occurrence
        instance:
          type: string
          description: A URI reference that identifies the specific occurrence
        extensions:
          type: object
          additionalProperties: {}
          description: Additional problem-specific properties
    NotFoundProblemDetail:
      type: object
      description: Not Found error details
      example:
        type: https://developers.gonitro.com/docs/build-nitro/errors#404-not-found
        title: Not Found
        status: 404
        detail: Envelope with ID 'envelop-123' not found
        instance: /sign/envelopes/envelop-123
      properties:
        type:
          type: string
          description: A URI reference that identifies the problem type
        title:
          type: string
          description: A short, human-readable summary of the problem type
        status:
          type: integer
          format: int32
          description: The HTTP status code
        detail:
          type: string
          description: A human-readable explanation specific to this occurrence
        instance:
          type: string
          description: A URI reference that identifies the specific occurrence
        extensions:
          type: object
          additionalProperties: {}
          description: Additional problem-specific properties
    Participant:
      type: object
      properties:
        ID:
          type: string
          format: uuid
          description: The unique identifier of the participant
        email:
          type: string
          description: The email address of the participant
        role:
          type: string
          description: The role of the participant
        authentication:
          description: Participant authentication
          oneOf:
            - $ref: '#/components/schemas/AccessCode'
            - $ref: '#/components/schemas/SMS'
    AccessCode:
      description: Access code
      properties:
        accessCode:
          type: string
          description: Access code. It must contain between 4-32 characters.
        type:
          type: string
          enum:
            - AccessCode
          title: type
      title: Access Code
    SMS:
      description: SMS
      properties:
        countryCode:
          type: string
          description: >-
            Country code. It must start with `+` and be followed by 1-4 digits.
            For example +1, +55, +598
        phoneNumber:
          type: string
          description: >-
            Phone number. Enter digits only, without a country code or
            formatting characters.
        type:
          type: string
          enum:
            - SMS
          title: type
      title: SMS
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````