curl -X GET "https://app.famulor.de/api/user/whatsapp/senders" \
-H "Authorization: Bearer YOUR_API_KEY"
curl -X GET "https://app.famulor.de/api/user/whatsapp/senders?status=all" \
-H "Authorization: Bearer YOUR_API_KEY"
const response = await fetch(
'https://app.famulor.de/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.famulor.de/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"
},
{
"id": 15,
"phone_number": "+442071234567",
"display_name": "Acme Corp Sales",
"status": "online",
"quality_rating": "GREEN",
"messaging_limit": null,
"messaging_limit_formatted": "Unlimited"
}
]
}
{
"data": []
}
Get WhatsApp Senders
List WhatsApp Business senders configured in your Famulor account
GET
/
user
/
whatsapp
/
senders
curl -X GET "https://app.famulor.de/api/user/whatsapp/senders" \
-H "Authorization: Bearer YOUR_API_KEY"
curl -X GET "https://app.famulor.de/api/user/whatsapp/senders?status=all" \
-H "Authorization: Bearer YOUR_API_KEY"
const response = await fetch(
'https://app.famulor.de/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.famulor.de/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"
},
{
"id": 15,
"phone_number": "+442071234567",
"display_name": "Acme Corp Sales",
"status": "online",
"quality_rating": "GREEN",
"messaging_limit": null,
"messaging_limit_formatted": "Unlimited"
}
]
}
{
"data": []
}
Retrieve all WhatsApp Business senders (phone numbers) configured in your Famulor account. Use this endpoint to obtain
sender_id values needed for sending WhatsApp messages via the Famulor API.
Query Parameters
string
Filter senders by status. Default:
online. Use all to return all senders regardless of status.Response Fields
array
Show Sender object properties
Show Sender object properties
integer
The unique identifier of the WhatsApp sender. Use this ID when sending messages.
string
The sender’s phone number in E.164 format (e.g.,
+14155551234)string
The WhatsApp Business display name (business name shown to recipients)
string
The sender’s current status:
online or offlinestring
Meta’s quality rating for this sender:
GREEN, YELLOW, or REDinteger
The current messaging limit (number of unique recipients per 24 hours).
null means unlimited.string
Human-readable messaging limit (e.g.,
1,000 / 24hr, 10,000 / 24hr, or Unlimited)curl -X GET "https://app.famulor.de/api/user/whatsapp/senders" \
-H "Authorization: Bearer YOUR_API_KEY"
curl -X GET "https://app.famulor.de/api/user/whatsapp/senders?status=all" \
-H "Authorization: Bearer YOUR_API_KEY"
const response = await fetch(
'https://app.famulor.de/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.famulor.de/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"
},
{
"id": 15,
"phone_number": "+442071234567",
"display_name": "Acme Corp Sales",
"status": "online",
"quality_rating": "GREEN",
"messaging_limit": null,
"messaging_limit_formatted": "Unlimited"
}
]
}
{
"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.
Related pages: Introduction and Authentication Guide, and API Integration Examples.