View Categories

Envelope info

0:00 4:06

This section describes how to retrieve detailed information about a specific envelope using the Signatus 2 API. It explains how to access the envelope’s status, configuration, and related metadata to understand its current state within the workflow.

Retrieves detailed information about a specific envelope based on its unique identifier (id).

Service specifications: #

URL/api/envelope/{id}
MethodGET
AuthenticationBearer access token
Response typeapplication/json

Request description #

Request path variable:

KeyTypeDescription
idpathThe envelope id retrieved from the response body of the Create envelope service
HTTP- Click to view HTTP code snippet 
GET /app/api/envelope/9ec82484-8af0-45ef-9c52-c80895905379 HTTP/1.1
Host: signatus.ana.sk
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICJJTGNWSnp4SFkyd1RDcGlLZU5Oa2VmbWZHa1ljUnBtQ1lMMUhsNG13Zm5VIn0.eyJleHAiOjE3NTM5NTIzNzEsImlhdCI6MTc1Mzk1MjA3MSwianRpIjoiYWI1YTJlYmEtNTZkZi00Y2ZkLTkyOGYtMTU3ZWMyYzU1N2RlIiwiaXNzIjoiaHR0cHM6Ly9vYXV0aC5hbmEuc2svcmVhbG1zL1NpZ25hdHVzIiwiYXVkIjoiYWNjb3VudCIsInN1YiI6ImYzYmUxYTY2LTU1M2YtNGFlOC04OTUyLTY3OGQ4NTU2ZDAxYiIsInR5cCI6IkJlYXJlciIsImF6cCI6InNpZ25hdHVzIiwic2lkIjoiYTczMTkzMmItOTAyNC00ZWU5LWFlOTEtNWZlNTJmYWIzNjliIiwiYWNyIjoiMSIsImFsbG93ZWQtb3JpZ2lucyI6WyIvKiJdLCJyZWFsbV9hY2Nlc3MiOnsicm9sZXMiOlsiUk9MRV9QUk9YWSIsImRlZmF1bHQtcm9sZXMtc2lnbmF0dXMiLCJST0xFX1BPUlRBTCIsIlJPTEVfVVNFUiJdfSwicmVzb3VyY2VfYWNjZXNzIjp7ImFjY291bnQiOnsicm9sZXMiOlsibWFuYWdlLWFjY291bnQiLCJtYW5hZ2UtYWNjb3VudC1saW5rcyIsInZpZXctcHJvZmlsZSJdfX0sInNjb3BlIjoicGhvbmUgZ3JvdXBzIHRlbmFudGlkIHByb2ZpbGUgZW1haWwiLCJlbWFpbF92ZXJpZmllZCI6ZmFsc2UsInRlbmFudGlkIjoiZGVtbyIsIm5hbWUiOiJQYXZvbCBQdW5hIiwicHJlZmVycmVkX3VzZXJuYW1lIjoiZGVtby5hcGkiLCJnaXZlbl9uYW1lIjoiUGF2b2wiLCJmYW1pbHlfbmFtZSI6IlB1bmEiLCJlbWFpbCI6InBhdm9sLnB1bmFAYW5hc29mdC5jb20ifQ.PP-jqR34m5dLEzpLNKK0hgk2PM9L3Q2WqR9aZjFRRG7mPZJ538gqlyh9WZU8R33njAjIq6Uo4Ty8qTrwGgRrpqnA8lVRvPnKimLzN8qDmAzBE29JxitQ3AYLC4VFpvp2zU0WTugypE84X1Km3Dd5O8efhDe2M41LNtsaT1ys2Y8qZb6dZVkTOexQ2YAqycCE4TCD1bPXYRQzI2miiuiz2Ik0KK-3ommk7C4JM83jw1ZxZF3ZLka7xmILxKZcHqIkahPDltmF-yxox5yPKIwnbbgvu8M8oqgsZp33fEH-6I4p8jInzymDseYze0O0hDdHzb58aV-cmoDXb5YBQ5VDtQ

Response description #

Status codeDescription
200 OKEnvelope metadata
401 UnauthorizedWhen user is not authenticated
403 ForbiddenWhen user lacks required permissions
404 Not FoundIf the envelope with the specified id does not exist.
500 Internal Server ErrorServer processing error

Success response example :

{
  "id": "90523892-4bff-42e0-b151-89e967db0658",
  "userId": "demo.api",
  "created": 1730308840000,
  "updated": 1730308840000,
  "state": "ready",
  "envelopetypeid": 27,
  "expirationtime": 1730395240000,
  "extension": {},
  "processes": [
    {
      "id": "655daf4d-409d-454f-a566-b8fd92223f50",
      "userId": "demo.api",
      "created": 1730308840000,
      "updated": 1730308840000,
      "envelopeid": "90523892-4bff-42e0-b151-89e967db0658",
      "signer": "user",
      "state": "ready",
      "extension": {},
      "sigtype": "bio",
      "envelopetypeid": 27,
      "tenant": "demo",
      "user": "demo.api",
      "rules": {}
    }
  ],
  "type": "menu1",
  "folder": "Contract",
  "name": "Contract no. 1245726",
  "source": "api",
  "product": [],
  "contact": {},
  "tenant": "demo",
  "rules": {}
}

Error response example :

{
    "message": "err.envelope.load",
    "value": ""
}