Viber Number Validation & Profile Lookup APIs
Check in real time whether a phone number is registered on Viber and enrich it with public profile data.
- Profile: Viber display name and account profile photo
- Identifiers: internal memberId and viberId, per-number registration status
- Envelope: replies wrap as {"code", "data"} β HTTP is always 200, the outcome is in code and data.registered
- One call: a single GET by phone number returns registered=true/false plus profile fields
RESTful JSON API for lead validation, identity resolution, CRM enrichment, and anti-fraud signals.
Overview
Base URL https://api.opendata-api.com
Every call needs an API key. Paste it once below β it's attached to each request automatically.
/api/project/viber/check Check Viber Registration
Full docs β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
Full docs β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
Full docs β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 |