Get call permission state

Developing

GET

/v1/whatsapp/{whatsappApiVersion}/{whatsappPhoneNumberId}/call_permissions

Returns the call permission state between a business phone number and a WhatsApp user.

Mirrors Meta's GET /{PHONE_NUMBER_ID}/call_permissions endpoint.

Identify the user by user_wa_id (phone number) or recipient (business-scoped user ID).
At least one of these query parameters is required.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Query Params

Responses

🟢200

application/json

Call permission state retrieved successfully.

Bodyapplication/json

🟢200MetaError

🟠400ChakraBadRequest

🟠401Unauthorized

Request Example

Shell

JavaScript

Java

Swift

curl --location '/v1/whatsapp///call_permissions?user_wa_id=&recipient=' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Success

{
    "messaging_product": "whatsapp",
    "permission": {
        "status": "temporary",
        "expiration_time": 1745343479
    },
    "actions": [
        {
            "action_name": "send_call_permission_request",
            "can_perform_action": true,
            "limits": [
                {
                    "time_period": "PT24H",
                    "max_allowed": 1,
                    "current_usage": 0
                }
            ]
        },
        {
            "action_name": "start_call",
            "can_perform_action": false,
            "limits": [
                {
                    "time_period": "PT24H",
                    "max_allowed": 5,
                    "current_usage": 5,
                    "limit_expiration_time": 1745622600
                }
            ]
        }
    ]
}

Modified at 2026-07-01 11:58:57

Configure or update calling settings

Manage a call