An Envelope is a workflow wrapper that shepherds one or more Documents through the various recipients in a signing process.

interface IEnvelope {
    canceled_at: string;
    certificate?: null | IEnvelopeDocument;
    certificate_document_id: null | string;
    created_at: string;
    document?: null | IEnvelopeDocument;
    documents?: null | IEnvelopeDocument[];
    envelope_document_id: string;
    fields?: IEnvelopeField[];
    histories: IHistory[];
    id: string;
    name: string;
    no_contact: boolean;
    organization_id: null | string;
    profile?: null | IProfile;
    profile_id: string;
    recipients: IRecipient[];
    reminder_id: null | string;
    status: "canceled" | "complete" | "pending" | "in progress" | "declined";
    template_id: string;
    updated_at: string;
    visibility: "shared" | "private";
}

Properties

canceled_at: string
certificate?: null | IEnvelopeDocument
certificate_document_id: null | string

@deprecated. New envelopes may have more than one certificate attached.

created_at: string
document?: null | IEnvelopeDocument

@deprecated. New code should use documents[].

documents?: null | IEnvelopeDocument[]

Documents attached to this envelope

envelope_document_id: string

@deprecated. New envelopes will support more than one document attachment so new code should no longer refer to this field.

fields?: IEnvelopeField[]
histories: IHistory[]
id: string
name: string
no_contact: boolean
organization_id: null | string
profile?: null | IProfile
profile_id: string
recipients: IRecipient[]
reminder_id: null | string
status: "canceled" | "complete" | "pending" | "in progress" | "declined"
template_id: string
updated_at: string
visibility: "shared" | "private"

Defaults to 'private'. If set to 'shared', this envelope will be visible to other users in the same organization. Ignored for personal profiles.