Get senders

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

string

default:"online"

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

Response

array

Array of WhatsApp sender objects.

Show Sender properties

integer

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

string

Sender’s phone number in E.164 format.

string

WhatsApp Business display name shown to recipients.

string

Current status: online or offline.

string

Meta quality rating: GREEN, YELLOW, or RED.

integer

Maximum unique recipients per 24 hours. null means unlimited.

string

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

Example

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

const response = await fetch('https://portal.intellixent.ai/api/user/whatsapp/senders', {
  headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
});

const data = await response.json();
const senders = data.data;

200 Response

{
  "data": [
    {
      "id": 12,
      "phone_number": "+14155551234",
      "display_name": "Acme Corp Support",
      "status": "online",
      "quality_rating": "GREEN",
      "messaging_limit": 10000,
      "messaging_limit_formatted": "10,000 / 24hr"
    },
    {
      "id": 15,
      "phone_number": "+442071234567",
      "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.

Overview

Assistants

Calls

Campaigns & Leads

Conversations

Messaging

Phone Numbers

Knowledge & Tools

Webhooks

Endpoint

Query parameters

Response

Example

​Endpoint

​Query parameters

​Response

​Example

Endpoint

Query parameters

Response

Example