---
title: Envelope info
description: 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…
url: "https://wiki.signatus.com/documentation/signatus-2-api/envelope-info/"
updated: "2026-10-13"
category: "Core API Services - Signatus 2"
---

# Envelope info

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} |
| --- | --- |
| Method | GET |
| Authentication | Bearer access token |
| Response type | application/json |

## Request description

Request path variable:

| Key | Type | Description |
| --- | --- | --- |
| id | path | The 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 code | Description |
| --- | --- |
| 200 OK | Envelope metadata |
| 401 Unauthorized | When user is not authenticated |
| 403 Forbidden | When user lacks required permissions |
| 404 Not Found | If the envelope with the specified id does not exist. |
| 500 Internal Server Error | Server 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": ""
}
```