Waplix
Docs

Get Blocked Contacts

Supported & Tested

Return the currently blocked contacts known to the WhatsApp engine for this instance.

GEThttps://api.waplix.io/api/v1/contacts/blocked?instance_id=39058
Authentication
Authorization: Bearer YOUR_API_KEY
Parameters Specification
instance_id
stringReq

Required Waplix instance id

Usage Notes
Verified on production instance 29854.
Request Payload Example
Request 
curl -X GET "https://api.waplix.io/api/v1/api/v1/contacts/blocked?instance_id=39058" \
  -H "Authorization: Bearer YOUR_API_KEY"
Success Response
Response · 200 OK
{
  "success": true,
  "data": {
    "items": [
      {
        "lid": "15551234567@s.whatsapp.net",
        "name": "John Doe",
        "notify": "John Doe",
        "phone_number": "15551234567",
        "is_business": false,
        "is_blocked": true,
        "input_contact_id": "15551234567@s.whatsapp.net",
        "phone_jid": "15551234567@s.whatsapp.net",
        "lid_jid": "15551234567@s.whatsapp.net",
        "resolved_jid": "15551234567@s.whatsapp.net",
        "display_id": "15551234567@s.whatsapp.net",
        "resolution_source": "stored_chat_id",
        "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"
        },
        "status": "blocked"
      },
      {
        "lid": "15551234567@s.whatsapp.net",
        "name": "Demo User",
        "notify": "Demo User",
        "phone_number": "15551234568",
        "is_business": false,
        "is_blocked": true,
        "input_contact_id": "15551234567@s.whatsapp.net",
        "phone_jid": "15551234567@s.whatsapp.net",
        "lid_jid": "15551234567@s.whatsapp.net",
        "resolved_jid": "15551234567@s.whatsapp.net",
        "display_id": "15551234567@s.whatsapp.net",
        "resolution_source": "stored_chat_id",
        "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"
        },
        "status": "blocked"
      }
    ]
  }
}
Previous Unblock ContactNext Get Common Groups with Contact
Was this page helpful?