WhatsApp
Get WhatsApp Senders
List all WhatsApp Business senders for the authenticated user
GET
/
user
/
whatsapp
/
senders
curl -X GET "https://app.receptonic.com/api/user/whatsapp/senders" \
-H "Authorization: Bearer YOUR_API_KEY"
curl -X GET "https://app.receptonic.com/api/user/whatsapp/senders?status=all" \
-H "Authorization: Bearer YOUR_API_KEY"
const response = await fetch(
'https://app.receptonic.com/api/user/whatsapp/senders',
{
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
}
);
const data = await response.json();
console.log(data.data); // Array of senders
import requests
response = requests.get(
'https://app.receptonic.com/api/user/whatsapp/senders',
headers={'Authorization': 'Bearer YOUR_API_KEY'}
)
senders = response.json()['data']
for sender in senders:
print(f"{sender['display_name']}: {sender['phone_number']}")
{
"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",
"voice_calling_enabled": true
},
{
"id": 15,
"phone_number": "+442071234567",
"display_name": "Acme Corp Sales",
"status": "online",
"quality_rating": "GREEN",
"messaging_limit": null,
"messaging_limit_formatted": "Unlimited",
"voice_calling_enabled": false
}
]
}
{
"data": []
}
This endpoint returns a list of WhatsApp Business senders (phone numbers) configured for your account. Use this to retrieve sender IDs needed for sending messages.
Query Parameters
Filter senders by status. Default:
online. Use all to return all senders regardless of status.Response Fields
Show Sender object properties
Show Sender object properties
The current messaging limit (number of unique recipients per 24 hours).
null means unlimited.true when WhatsApp Calling is enabled on this sender. See WhatsApp Calling.curl -X GET "https://app.receptonic.com/api/user/whatsapp/senders" \
-H "Authorization: Bearer YOUR_API_KEY"
curl -X GET "https://app.receptonic.com/api/user/whatsapp/senders?status=all" \
-H "Authorization: Bearer YOUR_API_KEY"
const response = await fetch(
'https://app.receptonic.com/api/user/whatsapp/senders',
{
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
}
);
const data = await response.json();
console.log(data.data); // Array of senders
import requests
response = requests.get(
'https://app.receptonic.com/api/user/whatsapp/senders',
headers={'Authorization': 'Bearer YOUR_API_KEY'}
)
senders = response.json()['data']
for sender in senders:
print(f"{sender['display_name']}: {sender['phone_number']}")
{
"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",
"voice_calling_enabled": true
},
{
"id": 15,
"phone_number": "+442071234567",
"display_name": "Acme Corp Sales",
"status": "online",
"quality_rating": "GREEN",
"messaging_limit": null,
"messaging_limit_formatted": "Unlimited",
"voice_calling_enabled": false
}
]
}
{
"data": []
}
Notes
- Only senders with status
onlineare returned by default. Use?status=allto include offline senders. - Sender status is synced with Meta every 5 minutes automatically.
- The
idfield is what you need to pass assender_idwhen sending messages. - Quality rating affects your messaging limits. A
REDrating may restrict your ability to send messages.
⌘I
curl -X GET "https://app.receptonic.com/api/user/whatsapp/senders" \
-H "Authorization: Bearer YOUR_API_KEY"
curl -X GET "https://app.receptonic.com/api/user/whatsapp/senders?status=all" \
-H "Authorization: Bearer YOUR_API_KEY"
const response = await fetch(
'https://app.receptonic.com/api/user/whatsapp/senders',
{
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
}
);
const data = await response.json();
console.log(data.data); // Array of senders
import requests
response = requests.get(
'https://app.receptonic.com/api/user/whatsapp/senders',
headers={'Authorization': 'Bearer YOUR_API_KEY'}
)
senders = response.json()['data']
for sender in senders:
print(f"{sender['display_name']}: {sender['phone_number']}")
{
"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",
"voice_calling_enabled": true
},
{
"id": 15,
"phone_number": "+442071234567",
"display_name": "Acme Corp Sales",
"status": "online",
"quality_rating": "GREEN",
"messaging_limit": null,
"messaging_limit_formatted": "Unlimited",
"voice_calling_enabled": false
}
]
}
{
"data": []
}