Envelope Signing (eSign)API ReferenceGet Envelope Download Info

Get Envelope Download Info

POST/openapi/v1/envelopes/download-url

Get the download URLs for envelope files.

Only envelopes with status completed support download.

The file is generated in PDF format.


Request Parameters

AuthorizationRequiredstring
Bearer <access_token>
X-Operator-User-IdRequiredstring
Operator user ID (required, used for permission check)
application/json
EnvelopeIdRequiredstring
Envelope ID (required)

Response Parameters

EnvelopeIdOptionalstring
Envelope ID
StatusOptionalstring
Envelope status
FilesOptionalarray<object>
File info array
Sub-properties
FileTypeOptionalstring
File type (CONTRACT / ATTACHMENT)
CONTRACTATTACHMENT
FileNameOptionalstring
File name
DownloadUrlOptionalstring
Download URL

Error Codes

Error CodeDescription
OPENAPI.OPERATOR_USER_ID_REQUIREDMissing X-Operator-User-Id header
OPENAPI.OPERATOR_USER_NOT_FOUNDOperator is not a member of this space
INVALID_REQUESTInvalid parameters (e.g. EnvelopeId is empty)
NOT_FOUNDEnvelope does not exist
FORBIDDENOperator does not have permission to access the envelope
INTERNAL_ERRORInternal service error