Settings

Get phone number settings

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

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

Path parameters

Versionstring required
Example:v22.0
Phone-Number-IDstring required
Example:123456789012345

Query parameters

include_sip_credentialsboolean

Include SIP credentials in the response (requires additional permissions)

Headers

User-Agentstring
Example:Meta-Business-Messaging-OpenAPI/1.0.0;spec=2025-10-21

The user agent string identifying the client software making the request.

Authorizationstring required
Example:Bearer EAABwzLixnjYBOzYmNMJJGfHq9DgNh...

Bearer token for API authentication. This should be a valid access token obtained through the appropriate OAuth flow or system user token.

Content-Type'application/json' | 'application/x-www-form-urlencoded' | 'multipart/form-data' required
Example:application/json

Media type of the request body

Response

Current phone number settings retrieved successfully

Changes

No recorded changes to this operation across all 5 revisions of this API.