---
title: "List the values of a client list, or check one key"
method: GET
path: "/resources/api/agent/clientLists/{listId}/values"
tags: ["ClientListValuesApiAgentResource"]
---

# List the values of a client list, or check one key

`GET /resources/api/agent/clientLists/{listId}/values`

Returns a page of the list's values, newest first. With `key`, returns only the value whose key equals it exactly, or an empty result when the list does not hold it — use this to check one key instead of paging the whole list. For a `phone` list, `key` is converted to E.164 first, as when adding it.

## Path parameters

- `listId` string, required

## Query parameters

- `key` string
- `offset` integer
- `limit` integer

## Response `default`

default response

- EntityListClientListValueDto
  - `error` string
  - `items` ClientListValueDto[]
    - `createdAt` string, date-time — When the value was added.
    - `createdBy` string — Who added the value.
    - `desc` string — Free-text description of the value.
    - `id` string
    - `key` string — The key that rules match against.
    - `slug` string — Full name of the applicant, set only when the applicant was blocklisted from their profile.
  - `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/:listId/values/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)