Skip to main content
GET
/
user
/
my
/
privacy
Get Privacy Settings
curl --request GET \
  --url https://api.example.com/user/my/privacy \
  --header 'Authorization: <authorization>'
{
  "500": {},
  "code": "<string>",
  "message": "<string>",
  "results": {
    "group_add": "<string>",
    "last_seen": "<string>",
    "status": "<string>",
    "profile": "<string>",
    "read_receipts": "<string>"
  }
}
Get detailed information about your WhatsApp privacy settings including who can see your last seen, status, profile picture, and who can add you to groups.

​
Authentication

​
Authorization
string
required
Basic authentication credentials (username:password in base64)

​
Headers

​
X-Device-Id
string
Device identifier for multi-device support. Required when multiple devices are registered. If only one device is registered, it will be used as the default.

​
Response

​
code
string
Response code indicating success or failureExample: SUCCESS
​
message
string
Human-readable response messageExample: Success get privacy
​
results
object
Privacy settings data
​
group_add
string
Who can add you to groupsPossible values: all, contacts, contact_blacklist, noneExample: all
​
last_seen
string
Who can see your last seen timestampPossible values: all, contacts, contact_blacklist, none, nullExample: null
​
status
string
Who can see your status updatesPossible values: all, contacts, contact_blacklist, noneExample: all
​
profile
string
Who can see your profile picturePossible values: all, contacts, contact_blacklist, noneExample: all
​
read_receipts
string
Who can see your read receipts (blue ticks)Possible values: all, noneExample: all

​
Example Request

curl -X GET 'http://localhost:3000/user/my/privacy' \
  -u 'username:password' \
  -H 'X-Device-Id: my-device-id'

​
Response Example

{
  "code": "SUCCESS",
  "message": "Success get privacy",
  "results": {
    "group_add": "all",
    "last_seen": "null",
    "status": "all",
    "profile": "all",
    "read_receipts": "all"
  }
}

​
Error Responses

​
500
object
Internal Server Error
{
  "code": "INTERNAL_SERVER_ERROR",
  "message": "Failed to fetch privacy settings",
  "results": null
}

​
Privacy Setting Values

ValueDescription
allEveryone can see/do this
contactsOnly your contacts can see/do this
contact_blacklistYour contacts except those you’ve blocked
noneNobody can see/do this
nullSetting is not configured or hidden

​
Usage Notes

  • This endpoint is read-only; privacy settings cannot be changed via the API
  • To change privacy settings, use the WhatsApp mobile app
  • null values typically indicate the setting is either not configured or hidden for privacy
  • The read_receipts setting typically only has all or none values
  • Privacy settings affect both individual chats and group interactions
  • Some settings may be restricted by business accounts or enterprise policies

Build docs developers (and LLMs) love

Get started for freeTalk to us