POSTRequires Bearer token

Inspect PDF signatures

/api/verification/inspect

Detect existing electronic signatures before you edit the file. No cryptographic validation — use /api/verification/verify for that. Multipart only. Requires a Bearer token.

Path parameters

This endpoint has no path parameters.

Query parameters

This endpoint has no query parameters.

Request body

Send as multipart/form-data.

Field	Type	Description
file Required	string	PDF to inspect. e.g. "example"
password	string	Optional PDF password.

Responses

Status	Meaning
200	See the example response.
401	Missing or invalid Bearer token.

Request

curl

curl -X POST 'https://api.dkbsigns.com/api/verification/inspect' \
  -H 'Authorization: Bearer $DKBSIGN_TOKEN' \
  -H 'Accept: application/json' \
  -F 'file=example' \
  -F 'password=P@ssw0rd!'

Response 200

json

{
  "schema_version": "1.0",
  "filename": "doc.pdf",
  "page_count": 2,
  "signed": true,
  "signatures_count": 1,
  "has_document_timestamp": false
}