---
title: "Check Call Permissions"
method: GET
path: "/{Version}/{Phone-Number-ID}/call_permissions"
tags: ["Call Permissions"]
---

# Check Call Permissions

`GET /{Version}/{Phone-Number-ID}/call_permissions`

## Request

- Base URL: `https://graph.facebook.com`
- URL: `https://graph.facebook.com/{Version}/{Phone-Number-ID}/call_permissions`
- Auth: HTTP bearer

Check whether you have permission to call a WhatsApp user and what actions are available. This endpoint returns the current permission status for calling a specific user, along with available actions and their limits.

**Permission Status:**
- `granted`: You have active permission to call this user - `pending`: A permission request has been sent but not yet approved - `denied`: The user has denied call permissions - `expired`: Previous permission has expired

**Available Actions:**
- `start_call`: Initiate a new call to this user - `send_call_permission_request`: Send a permission request to this user

**Error Handling:**
This endpoint may return various error codes including rate limiting errors if too many permission checks are made within a short period.

## Query parameters

- `user_wa_id` string, required

## Headers

- `User-Agent` string
- `Authorization` string, required
- `Content-Type` 'application/json' | 'application/x-www-form-urlencoded' | 'multipart/form-data', required

## Response `200`

Call Permissions Check Success

- CallPermissionCheckResponsePayload
  - `messaging_product` string, required: Messaging product
  - `permission` object, required: Call permission details
    - `status` 'granted' | 'pending' | 'denied' | 'expired', required: Current permission status for calling this user
    - `expiration_time` integer: Unix timestamp when the permission expires (if applicable)
  - `actions` object[]: Available actions and their restrictions
    - `action_name` 'start_call' | 'send_call_permission_request', required: Name of the action
    - `can_perform_action` boolean, required: Whether the business can perform this action
    - `limits` object[]: Rate limits for this action
      - `time_period` string, required: Time period for the limit
      - `current_usage` integer, required: Current usage count
      - `max_allowed` integer, required: Maximum allowed usage
      - `limit_expiration_time` integer: Unix timestamp when the limit resets

## Other responses

- `400`: Bad Request - Invalid request parameters
- `403`: Forbidden - Template not approved or insufficient permissions
- `429`: Too Many Requests - Rate limit exceeded
- `500`: Internal Server Error - An unexpected error occurred

---

[API](https://skmtc.dev/meta/apis/whatsapp-business-messaging.md) - [All operations](https://skmtc.dev/meta/apis/whatsapp-business-messaging/llms.txt) - [OpenAPI document](https://skmtc.dev/meta/apis/whatsapp-business-messaging/revisions/5c1973265369?raw)