Get Contact About
Get the 'About' (status) text of a contact.
Authentication Required
Login to swap the placeholders with your real Instance ID and Access Token.
Log InNo query parameters required
This endpoint doesn't expect data in the URL.
Best practices
Cache this value; users rarely change their about text.
Use this to personalize the UI with the contact's current mood.
The "About" Section (Formerly Status)
The /v2/contacts/about endpoint retrieves the text status of a user (e.g., "Available", "At the gym", "Battery about to die").
📜 Terminology Confusion
"Wait, isn't Status a Story?"
- Old WhatsApp: The text under your name was called "Status".
- New WhatsApp: "Status" now refers to the 24-hour ephemeral stories (Snapchat style). The text field was renamed to "About".
- This Endpoint: Retrieves the text field, not the stories layer.
🔍 Use Cases
1. Availability Detection
Many users still use this field for its intended purpose.
- Values: "In a meeting", "Sleeping", "Emergency calls only".
- Logic: If you are building a routing system for a support team, you can check this field to see if an agent is "Available" before assigning a ticket.
2. Identity Verification
Some businesses put their official website or verification details in their About section.
- Example: "Official Support Account for BankXYZ. We will never ask for your password."
3. Last Seen Proxy
If a user freezes their "Last Seen" timestamp, their "About" section might still leak their activity if they update it frequently (e.g., automated tools that set "About" to current song playing).
🛡️ Privacy Barriers
Just like Profile Pictures, this field is subject to privacy settings.
- The Default: "My Contacts".
- The Consequence: If you message a new user, you likely will receive
nullor an empty string for this field until they save your number. - Business Accounts: Official Business Accounts (OBA) usually have this public.
🚦 Rate Limits
Fetching the "About" string requires a query to the primary WhatsApp server.
- Caching: The Wawp API caches this for 48 hours by default because users rarely change it.
- Latency: Expect ~200-500ms latency for a fresh fetch.
❓ FAQ
Q: Can I change my own About text?
A: Yes, use /v2/profile/about. This endpoint is only for reading other users' data.
Q: What is the character limit? A: WhatsApp enforces a limit of roughly 139 characters. It supports full Unicode (Emojis, Arabic, Chinese, etc.).
Request Parameters
Configure the parameters required to interact with this endpoint. All query and body arguments are listed below with their details.
Query Parameters & Request Body
Supported in URL Query String or JSON Bodystring | Your unique WhatsApp Instance ID Example: | ||
string | Your API Access Token Example: | ||
string | The unique ID of the contact Example: |
Build with AI using Wawp MCP
MCP READYConnect Wawp API directly to Cursor, Windsurf, or Claude Desktop. Let AI write, test, and execute your WhatsApp integration code automatically!
Request Samples
Use these ready-to-go code snippets to integrate our API into your project quickly and efficiently. Choose your preferred language and library.
Expected Responses
Explore all possible responses and outcomes from the server. We have documented each status code with data examples to make success and error handling easier.
Example
{
"about": "Available"
}Command Palette
Search for a command to run...