Skip to main content
GET
/
v1
/
contacts
/
avatar
# Get full image
curl -X GET "https://api.livchat.ai/v1/contacts/avatar?phone=5511999999999" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Get thumbnail
curl -X GET "https://api.livchat.ai/v1/contacts/avatar?phone=5511999999999&preview=true" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "url": "https://pps.whatsapp.net/v/t61.24694-24/...",
  "id": "1645308319",
  "type": "preview",
  "directPath": "/v/t61.24694-24/..."
}
Get the profile picture URL for a WhatsApp contact.

​
Query Parameters

​
phone
string
required
Phone number to get avatar for
​
preview
boolean
If true, returns thumbnail (96x96). If false, returns full image. Default: false

​
Response Fields

​
url
string
Direct URL to the profile picture
​
id
string
Picture ID (changes when picture is updated)
​
type
string
preview or image
# Get full image
curl -X GET "https://api.livchat.ai/v1/contacts/avatar?phone=5511999999999" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Get thumbnail
curl -X GET "https://api.livchat.ai/v1/contacts/avatar?phone=5511999999999&preview=true" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "url": "https://pps.whatsapp.net/v/t61.24694-24/...",
  "id": "1645308319",
  "type": "preview",
  "directPath": "/v/t61.24694-24/..."
}
Profile picture URLs are temporary and may expire. Cache the image data, not the URL.