---
title: "Get calling config for a number"
method: GET
path: "/v1/phone-numbers/{id}/whatsapp/calling"
tags: ["WhatsApp Calling"]
---

# Get calling config for a number

`GET /v1/phone-numbers/{id}/whatsapp/calling`

The WhatsApp Business Calling configuration of this number, keyed the
same way as the POST/PATCH/DELETE below (full read-write on one
sub-resource). Encrypted secrets are never returned; only a boolean
saying whether a SIP password is stored. The account-scoped read
(`GET /v1/whatsapp/calling?accountId=`) remains for callers that only
know the social account id, and additionally carries account-level
extras (billing eligibility, current-period spend).

## Path parameters

- `id` string, required

## Response `200`

Calling config

- object
  - `phoneNumber` string
  - `callingEnabled` boolean
  - `callDeepLink` string, nullable — Public calling deep link (https://wa.me/call/<number>). Null while calling is disabled.
  - `forwardTo` string, nullable — tel:+E164 / sip:... / wss://... destination
  - `recordingEnabled` boolean
  - `sipAuthUsername` string, nullable
  - `sipAuthPasswordConfigured` boolean — True when a SIP digest password is stored. The plaintext is never returned.
  - `callIconCountries` string[], nullable
  - `outboundDisabled` boolean — True when the number's country blocks business-initiated (outbound) WhatsApp calling; inbound still works.
  - `callerIdMode` 'business' | 'platform' — Caller ID the forward-leg callee sees on tel: forwards. business = this WhatsApp number; platform = a Zernio number (used when the number was brought by the customer and its caller ID is not verified for PSTN origination).
  - `callerIdVerified` boolean — True once the number completed caller-ID verification, making tel: forwards display the business number itself.
  - `maxCallDurationSeconds` integer, nullable — Hard cap (seconds) on forwarded calls; null = no cap.
  - `forwardCallerId` 'business' | 'caller'

## Other responses

- `400` — Invalid request
- `401` — Unauthorized
- `404` — Number not found

---

[API](https://skmtc.net/zernio/apis/zernio-api.md) · [All operations](https://skmtc.net/zernio/apis/zernio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zernio/zernio-api/versions/51932b099b2f/schema)