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

# List verifications

`GET /api/v1/verifications`

## Request

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

Get paginated list of verifications for the tenant.

## 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 verifications

- VerificationListResponse: Paginated list of verifications
  - `data` VerificationListItem[], 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
    - `status` 'pending' | 'verified' | 'failed' | 'expired' | 'revoked' | 'cancelled', required: Current status of the verification
    - `identifier` string: The identifier the verification was created for; absent for an identifier-free phone verification
    - `environment` 'production' | 'test', required
    - `created_at` string, date-time, required
    - `verified_at` string, date-time: Present once verified
  - `pagination` PaginationResponse, required: Pagination info in list responses
    - `page` integer
    - `limit` integer
    - `total` integer
    - `total_pages` integer

## 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)