Skip to main content
GET
/
v1
/
organization
/
whatsapp
/
phone-numbers
/
{phoneNumberId}
/
settings
cURL
curl --request GET \
  --url https://api.buildwithchirp.com/v1/organization/whatsapp/phone-numbers/{phoneNumberId}/settings \
  --header 'Authorization: Bearer <token>'
{
  "calling": {
    "status": "enabled",
    "callIconVisibility": "visible",
    "video": {
      "status": "enabled"
    },
    "ipAddresses": [
      "<string>"
    ],
    "callbackPermissionStatus": "granted",
    "sip": {
      "server": "<string>",
      "username": "<string>"
    }
  },
  "userIdentityChange": {
    "enableIdentityKeyCheck": true
  },
  "payloadEncryption": {
    "status": "enabled",
    "clientEncryptionKeyFingerprint": "<string>",
    "cloudEncryptionKey": "<string>"
  },
  "storageConfiguration": {
    "status": "default",
    "dataLocalizationRegion": "<string>"
  }
}

Authorizations

Authorization
string
header
required

Admin API key (format: sk_admin_*) for organization-level operations

Path Parameters

phoneNumberId
string
required

WhatsApp phone number ID (internal Chirp ID)

Example:

"wapn_2DbBs7GWhGvVNJGrDXr5RG0mBWI"

Response

Phone settings retrieved successfully

calling
object
required
userIdentityChange
object
required
payloadEncryption
object
required
storageConfiguration
object
required