Waplix
Docs

Get Contact Details by ID

Supported & Tested

Resolve and return the richest available contact identity details, including phone JID and LID when available.

POSThttps://api.waplix.io/api/v1/contacts/detail
Authentication
Authorization: Bearer YOUR_API_KEY
Parameters Specification
instance_id
stringReq

Required Waplix instance id

contact_id
stringReq

Required phone number or contact id

Usage Notes
Production verified. Manual verification completed.
Request Payload Example
Request 
curl -X POST "https://api.waplix.io/api/v1/api/v1/contacts/detail" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "instance_id": "demo_instance",
  "contact_id": "15551234567@s.whatsapp.net"
}'
Success Response
Response · 200 OK
{
  "success": true,
  "data": {
    "input_contact_id": "15551234567@s.whatsapp.net",
    "phone_jid": "15551234567@s.whatsapp.net",
    "lid_jid": null,
    "resolved_jid": "15551234567@s.whatsapp.net",
    "display_id": "15551234567@s.whatsapp.net",
    "resolution_source": "stored_chat_id",
    "phone_number": "15551234567",
    "source_row": {
      "id": 1001,
      "instance_id": "demo_instance",
      "direction": "incoming",
      "from_number": "15551234567@s.whatsapp.net",
      "to_number": "12025550102",
      "message_type": "text",
      "message": "Hello from Waplix API docs.",
      "media_url": null,
      "whatsapp_message_id": "MSG_DEMO_001",
      "status": "received",
      "created_at": "2026-06-23T12:00:00.000Z"
    },
    "name": "John Doe",
    "notify": "John Doe",
    "verified_name": null,
    "is_business": false,
    "profile_picture_url": "https://example.com/media/sample.jpg",
    "about": null,
    "source": "local_logs"
  }
}
Previous Get Profile Picture URLNext Add and Update Contact
Was this page helpful?