---
title: "Get phone number settings"
method: GET
path: "/{Version}/{Phone-Number-ID}/settings"
tags: ["Settings"]
---

# Get phone number settings

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

## Request

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

Retrieve current settings for a WhatsApp Business phone number.
Returns calling settings, payload encryption settings, and data
storage configurations.

## Path parameters

- `Version` string, required
- `Phone-Number-ID` string, required

## Query parameters

- `include_sip_credentials` boolean

## Headers

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

## Response `200`

Current phone number settings retrieved successfully

- PhoneNumberSettingsResponse
  - `calling` CallingSettingsResponse, required
    - `status` 'enabled' | 'disabled', required: Current calling feature status
    - `call_icon_visibility` 'visible' | 'hidden', required: Current call icon visibility setting
    - `ip_addresses` object, required
      - `default` string[], required: Default IP addresses for calling
    - `callback_permission_status` 'enabled' | 'disabled', required: Callback permission status
    - `srtp_key_exchange_protocol` 'DTLS-SRTP' | 'SDES-SRTP': SRTP key exchange protocol (optional)
    - `call_hours` CallHoursSettings
      - `status` 'enabled' | 'disabled', required: Call hours feature status
      - `timezone` string: Timezone for call hours
      - `day_of_week_start` string: Start day of the week
    - `call_icons` CallIconsSettings
      - `restrict_to_user_countries` string[]: List of countries where call icons are restricted
    - `sip` SipSettingsResponse
      - `status` 'enabled' | 'disabled', required: SIP calling status
      - `servers` SipServerInfo[]: SIP server configuration
        - `app_id` string, required: Application ID for SIP server
        - `hostname` string, required: SIP server hostname
        - `port` integer: SIP server port (optional)
        - `password` string: SIP password (only included when include_sip_credentials=true)
    - `video` VideoSettingsResponse
      - `status` 'enabled' | 'disabled', required: Video calling status
    - `audio` AudioSettingsResponse
      - `status` 'enabled' | 'disabled': Audio calling status
    - `restrictions` CallingRestrictionsResponse
      - `restrictions` object[]
        - `type` string: Type of restriction
        - `expiration` integer: Expiration timestamp for the restriction
  - `payload_encryption` PayloadEncryptionSettingsResponse
    - `status` 'enabled' | 'disabled', required: Payload encryption status
    - `client_encryption_key_fingerprint` string: Client encryption key fingerprint (when encryption is enabled)
    - `cloud_encryption_key` string: Cloud encryption key (when encryption is enabled)
  - `storage_configuration` StorageConfigurationSettingsResponse, required
    - `status` 'default' | 'in_country_storage_enabled', required: Data storage configuration status
    - `data_localization_region` string: Data localization region (when in-country storage is enabled)

## Other responses

- `400`: Bad Request - Invalid request parameters
- `403`: Forbidden - Template not approved or insufficient permissions

---

[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)