Viber Number Validation & Profile Lookup APIs

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).

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.

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 proxy path on the upstream API that always returns 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).