Wawp WhatsApp API
HomePricingHelp Center
HomePricingHelp Center
WhatsApp
API Status
  1. 🏷️ Labels
  • ⛓️‍💥 Session - instances
    • Wawp’s Session Lifecycle
    • Create new Session
      POST
    • Start Session
      POST
    • Stop Session
      POST
    • Restart Session
      POST
    • Delete Session
      DELETE
    • Logout Session
      POST
    • Get Session info
      GET
    • About WhatsApp Data
      GET
  • 📲 Authentication - Login
    • About login authentication
    • GET QR raw
      GET
    • GET QR image
      GET
    • Request code
      POST
  • 📤 Send Messages
    • Send Messages
    • Send Text
    • Send Image
    • Send List
    • Send Event
    • Send PDF
    • Send Voice
    • Send video
    • Send Link Preview
    • Send Location
    • Send poll
    • Send Contact Vcard
    • Mark message(s) as seen
    • Start typing
    • Stop typing
    • Reaction
  • ℹ️ Whatsapp Profile info
    • WhatsApp Profile Info
    • Get profile
    • Set display‑name
    • Set “About” status
    • Upload Whatsapp picture
    • Delete profile picture
  • 📢 Channels Control
    • Get list of know channels
    • Create a new channel.
    • Get channel info
    • Delete channel
    • Preview channel messages
    • Follow a channel
    • Unfollow a channel
    • Mute a channel
    • Unmute a channel
    • Search channels — by view
    • Search channels — by text
    • Search metadata — views / countries / categories
  • 🟢 Presence information
    • Presence API
    • Set session presence
    • Get the presence for the chat id
  • 🔊 24 Hour Status
    • Text status
    • Image status
    • Voice status
    • Video status
    • Delete status
  • 💬 Chats
    • Chats list & overview
    • chats overview
    • chats overview
    • Delete the chat
    • Get chat picture
    • Get messages in the chat.
    • Clear all messages from the chat.
    • Mark unread messages as read.
    • Get message by id
    • Delete a message
    • Edit a text message
    • Pin a message
    • Unpin a message
    • Archive the chat
    • Unarchive the chat
    • Mark chat as unread
  • 🪪 Contacts
    • Get all contacts
    • Get basic contact info
    • Check phone is on WhatsApp
    • Get contact “about”
    • Get contact profile picture (24h cache; add refresh=true to bust)
    • Block contact
    • Unblock contact
    • Create/Update contact on phone address book
    • Get all known lids to phone number mapping
    • Get the number of known lids
  • 👥 Groups
    • Get All List groups
    • Create a group
    • Join info (by code or URL)
    • Join group
    • Get the number of groups
    • Refresh groups from the server
    • Get the group
    • Delete the group
    • Leave the group
    • Get group picture
    • Set group picture
    • Delete group picture
    • Updates the group description
    • Updates the group subject
    • Updates the group "info admin only" settings
    • Update settings - who can send messages
    • Get settings - who can send messages
    • Set messages admin only
    • Get the invite code for the group
    • Invalidates the current group invite code and generates a new one
    • Get participants
    • Add participants
    • Remove participants
    • Promote participants to admin users
    • Demotes participants to regular users
  • 🏷️ Labels
    • Labels API
    • GET all labels
      GET
    • Create label
      POST
    • Update label
      PUT
    • DELETE label
      DELETE
    • Chats with a label
      GET
  • 🪝 Webhooks
    • Wawp’s Webhook API
    • session.status
    • message
    • message.reaction
    • message.any
    • message.ack
    • message.revoked
    • message.edited
    • group.v2.join
    • group.v2.leave
    • group.v2.update
    • group.v2.participants
    • presence.update
    • poll.vote.failed
    • chat.archive
    • call.received
    • call.accepted
    • call.rejected
    • label.upsert
    • label.deleted
    • label.chat.added
    • label.chat.deleted
    • event.response
    • event.response.failed
    • engine.event
  • Schemas
    • Sample Schemas
      • Pet
      • Category
      • Tag
HomePricingHelp Center
HomePricingHelp Center
WhatsApp
API Status
  1. 🏷️ Labels

Chats with a label

GET
https://wawp.net/wp-json/awp/v1/labels/{labelId}/chats
Retrieves a list of all chats (conversations) that are currently tagged with a specific label. This allows you to find all customers in a certain category (e.g., "get all chats labeled 'Pending Payment'").
Developer Tips:
**Response Format: **The endpoint returns an array of objects, where each object contains the id of a chat.
Chat IDs: These IDs can be standard phone-based JIDs (e.g., 1234567890@c.us) or, in some business API contexts, LID-based JIDs (e.g., 10932...@lid), as seen in your example. Both function as valid Chat IDs for other API calls (like sending messages).

Request

Path Params

Query Params

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://wawp.net/wp-json/awp/v1/labels//chats?instance_id=YOUR_INSTANCE&access_token=YOUR_TOKEN'

Responses

🟢200Success
application/json
Body

Example
[
    {
        "id": "1234567890@c.us"
    },
    {
        "id": "109324349268088@lid"
    }
]
Modified at 2026-01-03 02:41:38
Previous
DELETE label
Next
Wawp’s Webhook API
Built with