Skip to main content
GET
Get Call Permission
WhatsApp’s live answer for one person: may you call them right now, and how many permission requests and calls you have left. last_reply is their last answer to a request, as FlowIQ recorded it. Use /v1/calls/permissions?contact_id=… to look someone up by FlowIQ contact id.

Basic Usage


Path Parameters


Response

Success (200)


permission.status is no_permission, temporary (until expires_at) or permanent.

Authorizations

Authorization
string
header
required

Your FlowIQ organisation API key (Settings → API Keys), sent as a bearer token. Format: Bearer fiq_YOUR_API_KEY

Path Parameters

whatsapp_id
string
required

The person's WhatsApp number with country code

Response

Success

organization_id
string<uuid>
whatsapp_id
string
Example:

"27820000000"

contact_id
string<uuid> | null
permission
object
can_start_call
boolean

WhatsApp allows a call to this person right now

can_send_permission_request
boolean
limits
object
last_reply
object | null

The person's last answer to a permission request, as FlowIQ recorded it