Skip to main content
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

ParameterTypeDescription
searchstringSearch entries by value or display label
offsetintegerPagination offset (default: 0)
limitintegerPage size (default: 25)

Response fields

FieldTypeDescription
uuidstringUnique entry ID
valuestringThe blocklisted value (phone number, email, document number, IP, etc.)
display_labelstringHuman-readable label
commentstringComment or reason for adding
added_bystringWho added the entry (api, console, email, or system)
reference_session_idstring | nullSession ID this entry was created from (for session-based entries)
reference_session_numberinteger | nullSession number for display
reference_object_uuidstring | nullUUID 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.
metadataobject | nullStructured data. May include reference_type ("transaction", "vendor_user", "vendor_business"), document context (full_name, issuing_state), or face image URLs.
created_atstringISO 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"
    }
  ]
}