Get Started
Integrate / SDKs
User Verification
Business Verification
Transaction Monitoring
Changelogcurl -X GET "https://verification.didit.me/v3/lists/?list_type=blocklist" \
-H "x-api-key: YOUR_API_KEY"
{
"count": 10,
"next": null,
"previous": null,
"results": [
{
"uuid": "a1b2c3d4-...",
"name": "Face Blocklist",
"description": "Blocked biometric faces...",
"list_type": "blocklist",
"entry_type": "face",
"is_system": true,
"entry_count": 3,
"last_entry_added_at": "2025-06-09T12:26:54Z",
"created_at": "2025-01-01T00:00:00Z",
"updated_at": "2025-06-09T12:26:54Z"
}
]
}
Lists
List All Lists
GET /v3/lists/ — retrieve all blocklists, allowlists, and custom lists for your app. Filter by list type or entry type. Pay-per-call, no contracts.
GET
/
v3
/
lists
/
curl -X GET "https://verification.didit.me/v3/lists/?list_type=blocklist" \
-H "x-api-key: YOUR_API_KEY"
{
"count": 10,
"next": null,
"previous": null,
"results": [
{
"uuid": "a1b2c3d4-...",
"name": "Face Blocklist",
"description": "Blocked biometric faces...",
"list_type": "blocklist",
"entry_type": "face",
"is_system": true,
"entry_count": 3,
"last_entry_added_at": "2025-06-09T12:26:54Z",
"created_at": "2025-01-01T00:00:00Z",
"updated_at": "2025-06-09T12:26:54Z"
}
]
}
Retrieve a paginated list of all lists (blocklists, allowlists, custom) for your application. Filter by
list_type or entry_type.
Query parameters
| Parameter | Type | Description |
|---|---|---|
list_type | string | Filter by type: blocklist, allowlist, or custom |
entry_type | string | Filter by entry type: face, document, phone, email, ip_address, device_fingerprint, wallet_address, bank_account, country, user, business, key |
ordering | string | Sort by: created_at, -created_at, entry_count, -entry_count, last_entry_added_at, -last_entry_added_at |
offset | integer | Pagination offset (default: 0) |
limit | integer | Page size (default: 25) |
curl -X GET "https://verification.didit.me/v3/lists/?list_type=blocklist" \
-H "x-api-key: YOUR_API_KEY"
{
"count": 10,
"next": null,
"previous": null,
"results": [
{
"uuid": "a1b2c3d4-...",
"name": "Face Blocklist",
"description": "Blocked biometric faces...",
"list_type": "blocklist",
"entry_type": "face",
"is_system": true,
"entry_count": 3,
"last_entry_added_at": "2025-06-09T12:26:54Z",
"created_at": "2025-01-01T00:00:00Z",
"updated_at": "2025-06-09T12:26:54Z"
}
]
}
⌘I