DKBSignDocs

API reference

GETRequires Bearer token

List received envelopes

/api/v4/envelopes/received

Envelopes where the caller is a signer (matched by email, including delegates).

Path parameters

This endpoint has no path parameters.

Query parameters

This endpoint has no query parameters.

Request body

This endpoint does not accept a request body.

Responses

StatusMeaning
200Received envelopes
401Missing or invalid Bearer token.

Request

curl
curl -X GET 'https://api.dkbsigns.com/api/v4/envelopes/received' \
  -H 'Authorization: Bearer $DKBSIGN_TOKEN'

Response 200

json
{
  "envelopes": [
    {
      "batch_id": "550e8400-e29b-41d4-a716-446655440000",
      "title": "NDA Q1",
      "message": "Please sign",
      "signing_order": "ordered",
      "signature_level": "advanced",
      "password_protected": false,
      "status": "pending",
      "signed_count": 0,
      "signers_count": 1,
      "created_at": "2026-03-01T10:00:00Z",
      "documents": [
        {
          "uuid": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
          "name": "nda.pdf",
          "status": "pending"
        }
      ],
      "signers": [
        {
          "uuid": "signer-uuid",
          "full_name": "Jean Dupont",
          "email": "jean@example.com",
          "status": "pending",
          "signing_url": "https://app.example/sign/signer-uuid"
        }
      ]
    }
  ]
}