Skip to main content
GET
/
v3
/
blocklist
List Blocklist
curl --request GET \
  --url https://verification.didit.me/v3/blocklist/ \
  --header 'x-api-key: <api-key>'
{
  "count": 2,
  "next": null,
  "previous": null,
  "results": [
    {
      "type": "face",
      "session_id": "5b3720ed-d429-42ef-b67f-37ea805f48ee",
      "session_number": 720,
      "blocklisted_at": "2025-06-09T12:26:54.328364Z",
      "face_image": "https://example.com/face.jpg",
      "document_type": null,
      "document_number": null,
      "front_image": null,
      "phone_number": null,
      "country_code": null,
      "email": null
    },
    {
      "type": "document",
      "session_id": "6c8f0c7a-e872-4a6d-9703-489b6a7e17ec",
      "session_number": 19,
      "blocklisted_at": "2025-06-09T08:02:23.343053Z",
      "face_image": null,
      "document_type": "ID",
      "document_number": "ABC123456",
      "front_image": "https://example.com/document.jpg",
      "phone_number": null,
      "country_code": null,
      "email": null
    }
  ]
}

Authorizations

​
x-api-key
string
header
required

Query Parameters

​
item_type
enum<string>

Filter by item type: face, document, phone, or email. When omitted, returns all types.

Available options:
face,
document,
phone,
email
​
offset
integer
default:0

The number of items to skip before starting to return results.

​
limit
integer
default:20

The maximum number of items to return in the response.

Response

​
count
integer

Total number of blocklisted items.

​
next
string | null

URL to the next page of results.

​
previous
string | null

URL to the previous page of results.

​
results
object[]