POSTPublic

Rescan public identity

/api/v4/public/envelopes/{signer_uuid}/identity/rescan

Multipart selfie_frames[] (3–8). 422 IDENTITY_RESCAN_FAILED includes attempts_left.

Path parameters

Field	Type	Description
signer_uuid Required	string	Path parameter `signer_uuid`.

Query parameters

This endpoint has no query parameters.

Request body

Field	Type	Description
selfie_frames Required	array	3–8 liveness frames. e.g. ["example"]

Responses

Status	Meaning
200	Identity cleared
401	Missing or invalid Bearer token.

Request

curl

curl -X POST 'https://api.dkbsigns.com/api/v4/public/envelopes/550e8400-e29b-41d4-a716-446655440000/identity/rescan' \
  -H 'Content-Type: application/json' \
  -d '{"selfie_frames":["example"]}'

Response 200

json

{
  "cleared": true,
  "certificate": {
    "serial": "00:11:22",
    "expires_at": "2027-03-01"
  }
}