Signatures
Envelope Open
Opens a sent envelope as a recipient to view or sign documents.
- The envelope is identified using the transactionId (tid) query parameter, which can be obtained from the GET /signatures/envelope/list endpoint. tid is effectively required even for a logged-in caller, because the server always resolves a transaction token as part of authorization on this operation.
AuthorizationBearer <token>
JWT token to authenticate the request.
In: header
X-Api-Key<token>
API key, sent as a request header.
In: header
Query Parameters
tid?string
Transaction token identifying a specific recipient+envelope pair. Required for anonymous/recipient access (no Authorization header, or the header doesn't resolve to the envelope owner).
Format
uuidResponse Body
application/json
application/json
application/json
curl -X GET "https://example.com/signatures/envelope/open"{ "result": { "statusCode": 200, "message": "OK", "data": { "envelope": { "id": "string", "createdBy": { "id": "string", "name": "string", "email": "string" }, "subject": "string", "message": "string", "senderName": "string", "senderEmail": "string", "status": "string", "notifyWhenOpened": true, "notifyWhenSigned": true, "isSignOrder": true, "expireInDays": 0, "uploadDate": "string", "sendDate": "string", "locale": "string", "timezone": "string" }, "documents": [ { "id": "string", "name": "string" } ], "recipients": [ { "id": "string", "name": "string", "email": "string", "role": "signer", "status": "string", "signDate": "string", "signOrder": 0, "signGroupId": "string", "userId": "string", "mandatory": true, "hostEmail": "string" } ], "signGroups": [ { "id": "string", "name": "string", "role": "signer", "status": "string", "signOrder": 0, "mandatory": true } ], "fields": [ { "id": "string", "name": "string", "recipientId": "string", "signGroupId": "string", "documentId": "string", "type": "signature", "value": "string", "page": 0, "height": 0, "width": 0, "positionX": 0, "positionY": 0, "tooltip": "string", "isRequired": true, "properties": { "fontFamily": "string", "fontSize": 0, "color": "string", "bold": true, "italic": true, "underline": true, "textAlign": "string", "placeholder": "string", "isSignedDate": true, "selectionGroup": "string", "selectionValue": "string" }, "signerInfo": {} } ], "attachments": [ { "name": "string", "urn": "string", "mimeType": "string", "documentId": "string" } ], "signer": "string", "comments": {}, "savedSignatures": [ { "id": "string", "data": "string", "isDefault": true } ], "settings": [ {} ] } }, "origin": "string", "dateTime": "string"}{ "error": { "message": "Envelope not found.", "statusCode": 400, "innerErrors": [ { "code": "ENVELOPE_ID_INVALID", "message": "Envelope not found.", "userMessage": "Envelope not found." } ] }, "origin": "POST https://apim-mavenheadless-dev-westeu-1.azure-api.net/v1/signatures/envelope/create", "dateTime": "2026-07-20T12:00:00.0000000+00:00"}{ "error": { "message": "Envelope not found.", "statusCode": 400, "innerErrors": [ { "code": "ENVELOPE_ID_INVALID", "message": "Envelope not found.", "userMessage": "Envelope not found." } ] }, "origin": "POST https://apim-mavenheadless-dev-westeu-1.azure-api.net/v1/signatures/envelope/create", "dateTime": "2026-07-20T12:00:00.0000000+00:00"}