Get Profile Avatar (Display Photo)
View All WhatsApp Number Validation & Profile Lookup APIs →Fetch the public display photo (DP) of a WhatsApp user. Two-step flow: first call a check-exist endpoint to obtain a userHash for the target number, then pass that userHash here. Calls without a valid (or expired/unknown) userHash are rejected. The number is resolved from the userHash server-side — no phone parameter is accepted. If the user has no photo or hides it by privacy, hasAvatar=false. Use type to choose the full-size image or the small preview thumbnail.
API Features
Profile photo retrieval Get the public display photo URL for a WhatsApp user resolved from the userHash
Image or preview variant Choose the full-size image or a 96x96 preview thumbnail via the type parameter
Privacy-aware Clear hasAvatar flag and error code when the photo is hidden by privacy or not set
Live API Demo
🔒 Sign in to try it live
Log in to call this API with your own API key. New accounts get 1000 free credits — no card required.
Log in / Sign upNo active API key found. Create one in your Dashboard, then reload this page.Dashboard →
API Response (JSON)
{} Query Result
Need Help?
If you encounter API issues or need other API requirements, please contact us.
Use Cases
- Enrich CRM contacts with WhatsApp profile photos
- Show profile pictures in support or sales tools before a conversation
- Detect avatar changes using the returned content hash