{
  "id": "re_26w2VVV5JVm4j459TY5BNM",
  "envelope_id": "52872f0e-b919-4d69-89cd-e7e56af00548",
  "type": "signer",
  "key": "provider",
  "name": "Emily Johnson",
  "email": "emily@example.com",
  "status": "completed",
  "completed_at": "2025-12-31T15:00:00.000Z",
  "status_updated_at": "2025-12-31T15:00:00.000Z"
}

A recipient is a person who receives an envelope. A signer is a type of recipient.

A recipient belongs to an envelope.

​
Attributes

id
string

The unique identifier of the recipient.

envelope_id
uuid

The unique identifier of the envelope.

type
enum

The type of the recipient.

Available options: signer

key
string

A user-provided key that identifies a recipient within an envelope.

It must be up to 32 alphanumeric, lowercase characters and must start with a letter.

name
string

The name of the recipient.

email
string

The email address of the recipient.

status
enum

The current status of a recipient.

Available options are pending, sent, completed, rejected, soft_bounced, hard_bounced, failed, and replaced.

completed_at
timestamp

Time at which the envelope was completed by the recipient, in ISO 8601 format.

status_updated_at
timestamp

Time at which the status was last updated, in ISO 8601 format.

{
  "id": "re_26w2VVV5JVm4j459TY5BNM",
  "envelope_id": "52872f0e-b919-4d69-89cd-e7e56af00548",
  "type": "signer",
  "key": "provider",
  "name": "Emily Johnson",
  "email": "emily@example.com",
  "status": "completed",
  "completed_at": "2025-12-31T15:00:00.000Z",
  "status_updated_at": "2025-12-31T15:00:00.000Z"
}

Was this page helpful?

Cancel an envelopeRecipient lifecycle