---
title: "Get verified user"
method: GET
path: "/api/v1/verifications/users/{externalUserId}"
tags: ["Verifications"]
---

# Get verified user

`GET /api/v1/verifications/users/{externalUserId}`

## Request

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

Get all verifications for a specific external user. Returns detailed verification history including proof status.

## Path parameters

- `externalUserId` string, required: The external user ID to look up

## Response `200`

User verification details

- VerifiedUserDetail: Detailed verification info for a specific external user
  - `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
    - `status` 'pending' | 'verified' | 'failed' | 'expired' | 'revoked' | 'cancelled', required: Current status of the verification
    - `verified_at` string, date-time
    - `has_proof` boolean, required
    - `proof_expires_at` string, date-time
    - `created_at` string, date-time, required

## Other responses

- `404`: No verifications found for this user

---

[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/6b8d61ee354f?raw)