DKBSignDocs

API reference

GETRequires Bearer token

List signed documents

/api/v4/documents

Retrieve /api/v4/documents. Authenticated routes need Authorization: Bearer {token} from POST /api/v1/login.

Path parameters

This endpoint has no path parameters.

Query parameters

FieldTypeDescription
page
integerPage number (default 1).
e.g. 1
per_page
integerPage size (default 20, max 100).
e.g. 20
status
stringpending, signed, or refused.
e.g. "signed"
batch_id
stringLimit to one envelope / batch.

Request body

This endpoint does not accept a request body.

Responses

StatusMeaning
200Signed documents
401Missing or invalid Bearer token.

Request

curl
curl -X GET 'https://api.dkbsigns.com/api/v4/documents?page=1&per_page=20&status=signed&batch_id=uuid_or_id' \
  -H 'Authorization: Bearer $DKBSIGN_TOKEN'

Response 200

json
{
  "total": 1,
  "page": 1,
  "per_page": 20,
  "pages": 1,
  "documents": [
    {
      "uuid": "550e8400-e29b-41d4-a716-446655440000",
      "name": "contract.pdf",
      "status": "signed",
      "batch_id": "550e8400-e29b-41d4-a716-446655440000",
      "signed_url": "https://api.dkbsigns.com/api/v4/documents/550e8400-e29b-41d4-a716-446655440000/download",
      "created_at": "2026-03-01T10:00:00Z",
      "signed_at": "2026-03-01T10:05:00Z"
    }
  ]
}