Skip to main content
GET
Returns the current WhatsApp calling permission for one sender and one customer phone number. Use this before you ask or place a call.
Rate-limited to 20 requests per minute per user.

Query Parameters

integer
required
WhatsApp sender ID from Get Senders
string
required
Customer phone number in E.164 format (e.g. +40711222333)

Response Fields

boolean
Request succeeded
integer
The sender you queried
string
Normalized E.164 phone number
string
Conversation UUID if a chat already exists, otherwise null
string
pending, granted, rejected, revoked, expired, or null if never asked
boolean
true only when consent is granted and still valid
boolean
true when the 24-hour chat window is open and WhatsApp still allows another ask
boolean
true when the customer messaged this sender in the last 24 hours
string
When granted consent ends (ISO 8601), or null
string
When the last ask was sent (ISO 8601), or null

Notes

  • Only senders that belong to your account are visible. A missing or foreign sender_id returns SENDER_NOT_FOUND.
  • can_request is false when the chat window is closed — send a regular template and wait for a reply first. See WhatsApp Calling.
  • can_request and can_call are also false when the sender’s country does not allow business-initiated WhatsApp calls (United States, Canada, Egypt, Vietnam, Nigeria, Türkiye). Inbound calls still work.