Skip to main content
The Blocklist API lets you block and unblock verification items (faces, documents, phone numbers, emails) based on session ID. When a user attempts to verify, their data is automatically checked against your blocklist — if a match is found, the verification is declined.

​
Endpoints

Add to Blocklist

Block items from a session.

Remove from Blocklist

Unblock items from a session.

List Blocklist

Query all blocklisted items.

​
Supported item types

TypeDescription
faceFacial biometrics from the liveness check
documentDocument number from ID verification
phonePhone number from phone verification
emailEmail address from email verification
You can block multiple item types in a single request by passing the session ID and specifying which types to block.

​
How it works

  1. A user completes verification and is flagged as suspicious
  2. Call Add to Blocklist with the session ID and item types to block
  3. On future verifications, Didit automatically checks against your blocklist
  4. If a face, document, phone, or email matches a blocklisted item, the verification is automatically declined