Viber Number Validation & Profile Lookup — Try the interactive demo
A guided live test. Prefer the raw endpoints? See the API reference & playground →
Enter an API key from your Dashboard to enable the examples below. Requests send it to this platform for authentication.
Log in / Sign up · Dashboard →
Please paste your API key first.
Endpoints
Your API key is attached automatically to each call.
/api/project/viber/check Check Viber Registration
Details
The lightest, fastest call: returns only whether a phone number is a registered Viber account, without fetching profile or avatar data. Ideal for real-time form validation, sign-up gating, and high-volume list screening. Pass the full international number (digits, optional leading +); the API normalizes to digits only. registered is three-state: true = registered, false = not registered, null = undetermined (transient — see message, e.g. timeout or device offline).
| Parameter | In | Value |
|---|---|---|
| query |
/api/project/viber/user-info Get Viber Profile by Number
Details
Full lookup for a single number: registration status plus the public profile of the account — Viber display name (viberName), internal user identifiers (memberId, viberId), an authoritative per-number serverStatus (1 = registered, 3 = not registered), a human-readable message, and the lookup durationMs. Use this when you need contact enrichment, not just a yes/no. For the profile photo, use the Avatar endpoint rather than the opaque photo reference.
| Parameter | In | Value |
|---|---|---|
| query |
/api/project/viber/get-avatar Get Viber Profile Avatar
Details
Fetch the account's profile photo for a number in ready-to-use forms: signedUrl (a temporary, directly accessible image URL valid for a few hours — fetch it from any client, no auth), imageUrl (a stable link for retrieving the current image), and imageBase64 / dataUrl (the image inlined, convenient for embedding straight into an <img>). hasImage=false means the account has no public photo (or is not registered). Also echoes registered, viberName, and imageLen (image size in bytes).
| Parameter | In | Value |
|---|---|---|
| query |