---
title: "List Participant Signing URLs by Envelope ID"
method: GET
path: "/sign/envelopes/{envelopeID}/participants/signing-urls"
tags: ["Sign"]
---

# List Participant Signing URLs by Envelope ID

`GET /sign/envelopes/{envelopeID}/participants/signing-urls`

The **List Participant Signing URLs by Envelope ID** endpoint returns the URL and its expiry
for each participant of an envelope, for every role. Signers receive a URL into the signing
experience; CC participants receive a read-only view URL.

This endpoint is for senders who distribute the links themselves, so it requires the envelope
to have `notificationsManagedBy` set to `sender`. When Nitro manages the notifications it has
already emailed every participant their own link, and the request is rejected with a 409
response. Envelopes default to `nitro` when created without the field.

Note that a sender-managed envelope can only be sent for signing when every signer
authenticates by SMS, so in practice this endpoint serves envelopes that meet that
requirement too.

The envelope must also be in the SENT status; otherwise the request is rejected with a 409
response.

## Path parameters

- `envelopeID` string, uuid, required

## Response `200`

List participant signing URLs

- ParticipantSigningUrlList — #### Fields
  - `items` ParticipantSigningUrl[] — An array of participant signing URLs associated with the envelope
    - `participantID` string, uuid, required — The unique identifier of the participant
    - `signingUrl` string — The URL the participant uses to access the envelope. Signers are taken to the signing experience; CC participants are taken to a read-only view.
    - `expiresAt` string, date-time — Timestamp at which the URL expires
  - `total` integer — The total number of items available in the collection

## Other responses

- `401` — Unauthorized - Invalid or missing JWT token
- `404` — Envelope not found
- `409` — Envelope is not in the SENT status, or its notifications are managed by Nitro rather than the sender

---

[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/44cfae4dc99b/schema)