DKBSignDocs

API reference

POSTPublic

Verify public envelope OTP

/api/v4/public/envelopes/{signer_uuid}/verify

Unlocks documents and preview URLs. 400 if the code is invalid, expired, or too many attempts.

Path parameters

FieldTypeDescription
signer_uuid
Required
stringPath parameter signer_uuid.

Query parameters

This endpoint has no query parameters.

Request body

FieldTypeDescription
otp_code
Required
stringOne-time code sent to the signer.
e.g. "123456"

Responses

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

Request

curl
curl -X POST 'https://api.dkbsigns.com/api/v4/public/envelopes/550e8400-e29b-41d4-a716-446655440000/verify' \
  -H 'Content-Type: application/json' \
  -d '{"otp_code":"123456"}'

Response 200

json
{
  "verified": true,
  "message": "Code vérifié"
}