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

ParameterTypeDescription
list_typestringFilter by type: blocklist, allowlist, or custom
entry_typestringFilter by entry type: face, document, phone, email, ip_address, device_fingerprint, wallet_address, bank_account, country, user, business, key
orderingstringSort by: created_at, -created_at, entry_count, -entry_count, last_entry_added_at, -last_entry_added_at
offsetintegerPagination offset (default: 0)
limitintegerPage 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"
    }
  ]
}