Flows
Setup Endpoint Encryption
Business Encryption

Get Business Encryption Public Key

Retrieve the current business public key and its signature verification status.

This endpoint returns the public key that is currently configured for encrypting message payloads and indicates whether the stored signature is valid or has a mismatch.

Use Cases:

  • Verify current encryption configuration
  • Check public key signature validation status
  • Retrieve public key for client-side encryption setup
  • Monitor encryption key status for security compliance

Rate Limiting: Standard Graph API rate limits apply. Use appropriate retry logic with exponential backoff.

Caching: Public key information can be cached for moderate periods, but signature status may change and should be checked regularly for security validation.

get/{Version}/{Phone-Number-ID}/whatsapp_business_encryption

Request

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

Path parameters

Versionstring required

Graph API version to use for this request. Determines the API behavior and available features.

Phone-Number-IDstring required

Your WhatsApp Business phone number ID. This ID represents the phone number entity and can be obtained from your WhatsApp Business Account phone numbers list.

Query parameters

fieldsstring

Comma-separated list of fields to include in the response. If not specified, all available fields will be returned. Available fields: business_public_key, business_public_key_signature_status

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.

Response

Successfully retrieved business encryption public key information

Example response

{
  "data": [
    {
      "business_public_key": "-----BEGIN PUBLIC KEY-----\nMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA...\n-----END PUBLIC KEY-----\n",
      "business_public_key_signature_status": "VALID"
    }
  ]
}

Changes

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