Get Contact About

Get the 'About' (status) text of a contact.

GET
https://api.wawp.net/v2/contacts/about?access_token=123456789&contactId=123456789%40c.us&instance_id=123456789

Authentication Required

Login to swap the placeholders with your real Instance ID and Access Token.

Log In
Test /v2/contacts/about endpoint
GET
GET

No 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 null or 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 Body
string

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 READY

Connect Wawp API directly to Cursor, Windsurf, or Claude Desktop. Let AI write, test, and execute your WhatsApp integration code automatically!

How to Connect

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.

1const baseUrl = "https://api.wawp.net";
2const endpoint = "/v2/contacts/about";
3const params = new URLSearchParams({
4 "instance_id": "123456789",
5 "access_token": "123456789",
6 "contactId": "123456789@c.us"
7}).toString();
8
9
10fetch(`${baseUrl}${endpoint}${params ? '?' + params : ''}`, {
11 method: "GET",
12 headers: { "Content-Type": "application/json" },
13
14})
15 .then(async (response) => {
16 if (response.ok) {
17 const data = await response.json();
18 console.log("Success:", data);
19 return data;
20 }
21
22 // Error Handling
23 if (response.status === 401) {
24 console.error("Error 401: Unauthorized - Invalid or Missing Access Token");
25 }
26 if (response.status === 400) {
27 console.error("Error 400: Bad Request - Invalid Parameter Format");
28 }
29 if (response.status === 500) {
30 console.error("Error 500: Internal Server Error - Unexpected Failure");
31 }
32
33 const errorText = await response.text();
34 console.error(`Error ${response.status}: ${errorText}`);
35 })
36 .catch((error) => console.error("Network Error:", error));
Interactive Samples
Ln 36, Col 1javascript

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.

About info retrieved
application/json
string *

Example

{
"about": "Available"
}
Bad Request - Invalid Parameter Format
Unauthorized - Invalid or Missing Access Token
Internal Server Error - Unexpected Failure
Previous TopicCheck Phone on WhatsApp
Next TopicGet Contact Profile Picture

Command Palette

Search for a command to run...