---
title: "List verified users"
method: GET
path: "/api/v1/verifications/users"
tags: ["Verifications"]
---

# List verified users

`GET /api/v1/verifications/users`

## Request

- Base URL: `https://api.proof.holdings`
- URL: `https://api.proof.holdings/api/v1/verifications/users`
- Auth: HTTP bearer

List verified users grouped by `external_user_id`. Returns aggregated verification summaries for each user. Only includes verifications with an `external_user_id` set.

## Query parameters

- `page` integer
- `limit` integer
- `status` 'pending' | 'verified' | 'failed' | 'expired' | 'revoked' | 'cancelled': Current status of the verification
- `type` 'phone' | 'email' | 'domain' | 'social' | 'wallet' | 'account' | 'telegram_bot': Type of asset being verified

## Response `200`

List of verified users

- VerifiedUserListResponse: Paginated list of verified users
  - `data` VerifiedUserSummary[], required
    - `external_user_id` string, required
    - `verification_count` integer, required
    - `types_verified` VerificationType[], required
    - `verifications` object[], required
      - `id` string, required: MongoDB ObjectId
      - `type` 'phone' | 'email' | 'domain' | 'social' | 'wallet' | 'account' | 'telegram_bot', required: Type of asset being verified
      - `channel` 'whatsapp' | 'telegram' | 'sms' | 'email' | 'dns' | 'http' | 'auto' | 'github' | 'google' | 'facebook' | 'x' | 'linkedin' | 'instagram' | 'youtube' | 'tiktok' | 'ethereum' | 'solana' | 'bitcoin' | 'coinbase' | 'kraken' | 'telegram_bot_token', required: Channel used for verification
      - `identifier` string, required
      - `verified_at` string, date-time
    - `first_verified_at` string, date-time
    - `last_verified_at` string, date-time
  - `pagination` object, required
    - `page` integer, required
    - `limit` integer, required
    - `total` integer, required
    - `total_pages` integer, required

## Other responses

- `401`: Unauthorized

---

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