---
title: "List client lists"
method: GET
path: "/resources/api/agent/clientLists"
tags: ["ClientListApiAgentResource"]
---

# List client lists

`GET /resources/api/agent/clientLists`

Returns the client lists you have, including the lists that Sumsub maintains (type `system`). To find a list by its name, look it up in this result: rules reference a list as `clientLists.<name>`, while every other endpoint here takes the list `id`.

## Query parameters

- `offset` integer
- `limit` integer
- `fields` string
- `order` string
- `countTotalItems` boolean

## Response `default`

default response

- EntityListClientListDto
  - `error` string
  - `items` ClientListDto[]
    - `createdAt` string, date-time — When the list was created.
    - `desc` string — Free-text description of the list.
    - `entryType` string — Kind of key the list holds.
    - `id` string
    - `name` string — Name that rules reference the list by, as `clientLists.<name>`.
    - `title` string — Display title of the list.
    - `type` string — Purpose of the list: `custom`, `blocklist`, `whitelist`, or `system` for lists that Sumsub maintains.
  - `pageInfo` EntityPageInfo
    - `limit` integer
    - `offset` integer
  - `totalItems` integer

## Changes

- **2026-09-26** `c809e0d7cfdd` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/sumsub/apis/sumsub-api-service/changes/resources/api/agent/clientLists/get.md)

---

[API](https://skmtc.dev/sumsub/apis/sumsub-api-service.md) · [All operations](https://skmtc.dev/sumsub/apis/sumsub-api-service/llms.txt) · [OpenAPI document](https://skmtc.dev/sumsub/apis/sumsub-api-service/revisions/c809e0d7cfdd?raw)