Verifications

Get multi-channel group status

Poll the status of a multi-channel verification group. Returns a single group-level view with per-channel statuses and, once verified, the winning channel and its proof token.

get/api/v1/verifications/multi-channel/{group_id}/status

Request

  • Base URL: https://api.proof.holdings
  • URL: https://api.proof.holdings/api/v1/verifications/multi-channel/{group_id}/status
  • Auth: HTTP bearer

Path parameters

group_idstring required

Verification group ID

Example:vg_0123456789abcdef0123456789abcdef

Response

Group status

group_idstring required
status'pending' | 'verified' | 'expired' required

Group-level status: verified as soon as any channel completes

winning_channel'whatsapp' | 'telegram' | 'sms' required

Phone verification channel available for multi-channel groups

Example response

{
  "group_id": "vg_0123456789abcdef0123456789abcdef",
  "winning_channel": "whatsapp",
  "channels": [
    {
      "channel": "whatsapp",
      "verification_id": "507f1f77bcf86cd799439011",
      "status": "pending"
    }
  ],
  "proof": {
    "token": "eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9...",
    "expires_at": "2025-01-15T12:00:00Z",
    "confidence": "high"
  }
}

Changes

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