Get Started
Integrate / SDKs
User Verification
Business Verification
Transaction Monitoring
Changelogcurl -X GET "https://verification.didit.me/v3/lists/{list_uuid}/entries/?search=example" \
-H "x-api-key: YOUR_API_KEY"
{
"count": 2,
"next": null,
"previous": null,
"results": [
{
"uuid": "e1f2a3b4-...",
"value": "test@example.com",
"display_label": "",
"comment": "Reported as fraudulent",
"added_by": "api",
"reference_session_id": null,
"reference_session_number": null,
"reference_object_uuid": null,
"metadata": null,
"created_at": "2025-06-09T12:26:54Z"
},
{
"uuid": "a9b8c7d6-...",
"value": "0xd15ae8c92c304c5ca11778143480e391",
"display_label": "",
"comment": "",
"added_by": "console",
"reference_session_id": null,
"reference_session_number": null,
"reference_object_uuid": "e7f8a9b0-1234-5678-abcd-ef0123456789",
"metadata": {
"reference_type": "transaction",
"reference_id": "e7f8a9b0-1234-5678-abcd-ef0123456789"
},
"created_at": "2025-06-09T12:35:00Z"
}
]
}
Lists
List Entries
GET /v3/lists//entries/ — retrieve paginated entries in a Didit blocklist, allowlist, or custom list with search filtering. Pay-per-call.
GET
/
v3
/
lists
/
{list_uuid}
/
entries
/
curl -X GET "https://verification.didit.me/v3/lists/{list_uuid}/entries/?search=example" \
-H "x-api-key: YOUR_API_KEY"
{
"count": 2,
"next": null,
"previous": null,
"results": [
{
"uuid": "e1f2a3b4-...",
"value": "test@example.com",
"display_label": "",
"comment": "Reported as fraudulent",
"added_by": "api",
"reference_session_id": null,
"reference_session_number": null,
"reference_object_uuid": null,
"metadata": null,
"created_at": "2025-06-09T12:26:54Z"
},
{
"uuid": "a9b8c7d6-...",
"value": "0xd15ae8c92c304c5ca11778143480e391",
"display_label": "",
"comment": "",
"added_by": "console",
"reference_session_id": null,
"reference_session_number": null,
"reference_object_uuid": "e7f8a9b0-1234-5678-abcd-ef0123456789",
"metadata": {
"reference_type": "transaction",
"reference_id": "e7f8a9b0-1234-5678-abcd-ef0123456789"
},
"created_at": "2025-06-09T12:35:00Z"
}
]
}
Retrieve entries in a specific list with optional search filtering.
Query parameters
| Parameter | Type | Description |
|---|---|---|
search | string | Search entries by value or display label |
offset | integer | Pagination offset (default: 0) |
limit | integer | Page size (default: 25) |
Response fields
| Field | Type | Description |
|---|---|---|
uuid | string | Unique entry ID |
value | string | The blocklisted value (phone number, email, document number, IP, etc.) |
display_label | string | Human-readable label |
comment | string | Comment or reason for adding |
added_by | string | Who added the entry (api, console, email, or system) |
reference_session_id | string | null | Session ID this entry was created from (for session-based entries) |
reference_session_number | integer | null | Session number for display |
reference_object_uuid | string | null | UUID of the source entity — Face/KYC/Phone/Email object (for session entries), or transaction/vendor user/business UUID (for entity-based entries). Use with metadata.reference_type to navigate back to the source. |
metadata | object | null | Structured data. May include reference_type ("transaction", "vendor_user", "vendor_business"), document context (full_name, issuing_state), or face image URLs. |
created_at | string | ISO 8601 timestamp |
curl -X GET "https://verification.didit.me/v3/lists/{list_uuid}/entries/?search=example" \
-H "x-api-key: YOUR_API_KEY"
{
"count": 2,
"next": null,
"previous": null,
"results": [
{
"uuid": "e1f2a3b4-...",
"value": "test@example.com",
"display_label": "",
"comment": "Reported as fraudulent",
"added_by": "api",
"reference_session_id": null,
"reference_session_number": null,
"reference_object_uuid": null,
"metadata": null,
"created_at": "2025-06-09T12:26:54Z"
},
{
"uuid": "a9b8c7d6-...",
"value": "0xd15ae8c92c304c5ca11778143480e391",
"display_label": "",
"comment": "",
"added_by": "console",
"reference_session_id": null,
"reference_session_number": null,
"reference_object_uuid": "e7f8a9b0-1234-5678-abcd-ef0123456789",
"metadata": {
"reference_type": "transaction",
"reference_id": "e7f8a9b0-1234-5678-abcd-ef0123456789"
},
"created_at": "2025-06-09T12:35:00Z"
}
]
}
⌘I