Skip to main content
GET
/
api
/
contacts
/
profile-picture
Get contact's profile picture URL
curl --request GET \
  --url https://{host}/api/contacts/profile-picture \
  --header 'apikey: <api-key>'
{
  "url": "https://pps.whatsapp.net/v/t61.24694-24/...",
  "id": "1234567890",
  "type": "image"
}

​
Description

This endpoint returns the profile picture URL of a specific contact on WhatsApp. The returned URL can be used to download or display the profile image.

​
Query Parameters

​
sessionId
string
required
Authenticated session ID
​
jid
string
required
Contact identifier (WhatsApp JID). Format: 5511999999999@s.whatsapp.net
{
  "url": "https://pps.whatsapp.net/v/t61.24694-24/...",
  "id": "1234567890",
  "type": "image"
}

​
Status Codes

  • 200 - Picture URL returned successfully
  • 400 - Invalid parameters
  • 401 - Unauthorized session
  • 404 - Session, contact not found or contact has no profile picture

​
Usage Example

curl -X GET "https://api.wappfy.com.br/api/contacts/profile-picture?sessionId=my-session&jid=5511999999999@s.whatsapp.net"

Authorizations

​
apikey
string
header
required

Your Wappfy API key (get it at dash.wappfy.com.br)

Query Parameters

​
contactId
string
required
​
refresh
boolean
default:false

Refresh the picture from the server (24h cache by default). Do not refresh if not needed, you can get rate limit error

Response

200 - undefined