Skip to main content
GET
curl
Retrieve a paginated list of every active list of your application: the system lists Didit provisions (one blocklist per entry type, the High Risk Countries list, and any system allowlist) and the allowlists and custom lists you created. Filter by list_type or entry_type, and read a list’s values with List entries. See Lists for what each list type does during verification and transaction screening.

Authorizations

x-api-key
string
header
required

Your application's API key, from Developers -> API keys in the Business Console. The primary key has full access. A named key can be scoped: none, read or write per resource, limited to some workflows or to approved sessions, to a list of IP addresses, and to an expiry date. 401 means the key is wrong, revoked or expired; 403 means no key was sent, the key has no access to this resource or action, or the request came from an address outside its IP list; 404 on a session route means the session is outside the key's workflows or statuses. A key without media access receives image, video and PDF URLs as null, and a key without sessions write receives session links and tokens as null. See https://docs.didit.me/console/api-keys.

Query Parameters

list_type
enum<string>

Only lists of this type.

Available options:
blocklist,
allowlist,
custom
entry_type
enum<string>

Only lists of this entry type.

Available options:
face,
document,
phone,
email,
ip_address,
device_fingerprint,
wallet_address,
bank_account,
country,
user,
business,
key
ordering
enum<string>
default:-created_at

Sort order: -created_at (newest first, the default) or created_at (oldest first).

Available options:
-created_at,
created_at
limit
integer
default:50

Page size. Defaults to 50. A value above 1000000 returns 400; zero, a negative or a non-numeric value falls back to 50.

Required range: 1 <= x <= 1000000
offset
integer
default:0

Zero-based index of the first item to return. Prefer following next. A value above 1000000 returns 400; a negative or non-numeric value falls back to 0.

Required range: 0 <= x <= 1000000

Response

A page of lists.

count
integer
required

Total number of lists matching the filters.

Required range: x >= 0
next
string<uri> | null
required

Absolute URL of the next page, or null on the last page.

previous
string<uri> | null
required

Absolute URL of the previous page, or null on the first page.

results
object[]
required
Last modified on November 1, 2026