API Docs

Telegram verification API for single-number checks

Choose a service type, submit one phone number, and receive a synchronous product-specific result.

API at a glanceOne synchronous endpoint, one service type, and a consistent code / msg / data response envelope.

Authentication

Use an API key created in Settings and send it with every request.

X-API-Key: wac_your_api_key

Single check

POST /api/v1/check

service_typetg

identifierE.164 phone number with country code

Request body

{
  "service_type": "ws",
  "identifier": "+14155552671"
}

Product and result fields

tgTelegram Registration CheckConfirm whether a phone number is registered on Telegram.

1 credit

avatar=false and business=false is included only for compatibility with the shared response model. Always use registered for Telegram registration status.

Response examples

Every check returns the same code / msg / data envelope. The fields inside data reflect the Telegram registration result.

tgTelegram Registration Check1 credit

{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": 123,
    "identifier": "+14155552671",
    "registered": true,
    "transaction_id": "chk_example123",
    "status": "success",
    "service_type": "tg",
    "charged_credits": 1
  }
}

Error codes

40000Unsupported service type or conflicting request fields

40001Invalid JSON body

40002Invalid phone number

40100Missing or invalid API key

40200Insufficient credits

42900Rate limit exceeded

50300Validation service maintenance

cURL example

export WA_CHECKER_API_BASE="https://your-api-domain.com"

curl -X POST "$WA_CHECKER_API_BASE/api/v1/check" \
  -H "X-API-Key: wac_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{ "service_type": "ws", "identifier": "+14155552671" }'

Replace WA_CHECKER_API_BASE with the actual API base URL.

Create a free account