Verifications

List verified users

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

get/api/v1/verifications/users

Request

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

Query parameters

pageinteger
Example:1
limitinteger
Example:20
status'pending' | 'verified' | 'failed' | 'expired' | 'revoked' | 'cancelled'

Current status of the verification

Example:pending
type'phone' | 'email' | 'domain' | 'social' | 'wallet' | 'account' | 'telegram_bot'

Type of asset being verified

Example:phone

Response

List of verified users

Example response

{
  "data": [
    {
      "external_user_id": "user_12345",
      "verification_count": 3,
      "types_verified": [
        "phone",
        "email"
      ],
      "verifications": [
        {
          "id": "507f1f77bcf86cd799439011",
          "type": "phone",
          "channel": "whatsapp",
          "identifier": "+3706***9199"
        }
      ]
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 42,
    "total_pages": 3
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.