Privacy-First Channel
telegram logo

Telegram Verification

Verify phone numbers through Telegram's secure messaging platform. Privacy-focused, fast, and developer-friendly.

How It Works

Secure verification through Telegram bot interaction

Step 1

Create Request

Call our API with the phone number. We return a challenge code and Telegram bot deep link.

Step 2

User Messages Bot

User clicks the link to open Telegram and sends the challenge code to our verification bot.

Step 3

Instant Verification

Bot verifies the phone number matches and returns a cryptographic proof token via webhook.

API Integration

Integrate Telegram verification seamlessly

1. Create Verification Request

curl -X POST https://api.proof.holdings/api/v1/verifications \
  -H "Authorization: Bearer pk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "phone",
    "channel": "telegram",
    "identifier": "+37069199199"
  }'

2. Verify the Proof Token

# Poll for verification status
curl https://api.proof.holdings/api/v1/verifications/VERIFICATION_ID \
  -H "Authorization: Bearer pk_live_YOUR_API_KEY"

Response Example

{
  "id": "507f1f77bcf86cd799439011",
  "type": "phone",
  "channel": "telegram",
  "status": "pending",
  "identifier": "+37069199199",
  "challenge": {
    "code": "A7B3X9",
    "expires_at": "2026-03-15T11:00:00Z",
    "send_to": "@ProofHoldingsBot",
    "instruction": "Open Telegram and tap the button to share your phone number",
    "deep_link": "https://t.me/ProofHoldingsBot?start=507f1f77bcf86cd799439011"
  },
  "created_at": "2026-03-15T10:50:00Z"
}