Get senders

List your WhatsApp Business sender accounts.

Returns a list of WhatsApp Business senders (phone numbers) configured for your account. Use the sender id when sending messages.

Endpoint

GET /user/whatsapp/senders

Query parameters

status · string · default: "online"

Filter senders by status. Use all to return senders regardless of status. Default: online.

Response

data · array

Array of WhatsApp sender objects.

Show Sender properties

id · integer

Unique identifier of the sender. Pass this as sender_id when sending messages.

phone_number · string

Sender’s phone number in E.164 format.

display_name · string

WhatsApp Business display name shown to recipients.

status · string

Current status: online or offline.

quality_rating · string

Meta quality rating: GREEN, YELLOW, or RED.

messaging_limit · integer

Maximum unique recipients per 24 hours. null means unlimited.

messaging_limit_formatted · string

Human-readable messaging limit (e.g., 10,000 / 24hr, Unlimited).

Example

cURL

curl -X GET "https://portal.intellixent.ai/api/user/whatsapp/senders" \
  -H "Authorization: Bearer YOUR_API_KEY"

200 Response

{
  "data": [
    {
      "id": 12,
      "phone_number": "[phone]",
      "display_name": "Acme Corp Support",
      "status": "online",
      "quality_rating": "GREEN",
      "messaging_limit": 10000,
      "messaging_limit_formatted": "10,000 / 24hr"
    },
    {
      "id": 15,
      "phone_number": "[phone]",
      "display_name": "Acme Corp Sales",
      "status": "online",
      "quality_rating": "GREEN",
      "messaging_limit": null,
      "messaging_limit_formatted": "Unlimited"
    }
  ]
}

Only online senders are returned by default. Use ?status=all to include offline senders. Sender status is synced with Meta every 5 minutes.