---
title: "Check call permission for a user"
method: GET
path: "/v1/whatsapp/call-permissions"
tags: ["WhatsApp"]
---

# Check call permission for a user

`GET /v1/whatsapp/call-permissions`

## Request

- Base URL: `https://api.pyai.com`
- URL: `https://api.pyai.com/v1/whatsapp/call-permissions`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`

Whether you may place a business-initiated call to `user` from `number_id`. Temporary permissions last 7 days; permanent ones until the user revokes them. Served from PyAI's cache when live, otherwise refreshed from Meta (`refresh=true` forces it). Requires the `telephony:manage` scope.

## Query parameters

- `number_id` string, required
- `user` string, required
- `refresh` boolean

## Response `200`

Permission state

- WhatsAppCallPermission
  - `object` string
  - `number_id` string
  - `user` string
  - `status` 'temporary' | 'permanent' | 'rejected' | 'none'
  - `source` string, nullable: user_action | automatic | api
  - `expires_at` integer, nullable: Unix ms (temporary only).
  - `updated_at` integer

## Other responses

- `401`: Missing or invalid API key (`code: unauthorized`)
- `404`: Resource not found (`code: not_found`)

---

[API](https://skmtc.dev/pyai/apis/pyai-api.md) · [All operations](https://skmtc.dev/pyai/apis/pyai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pyai/apis/pyai-api/revisions/271a1539185b?raw)