MEmeta
Pre-Verified Phone Number Partners

Get Pre-Verified Phone Number Partners

Retrieve the list of partner businesses that have been granted access to a specific WhatsApp Business Pre-Verified Phone Number.

Use Cases:

  • Monitor partner business relationships and access permissions
  • Verify which businesses have access to shared pre-verified phone numbers
  • Retrieve partner business information for operational purposes
  • Validate partnership configurations before business operations

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

Caching: Partner information can be cached for moderate periods, but partnership relationships may change. Implement appropriate cache invalidation strategies.

get/{Version}/{Pre-Verified-Phone-Number-ID}/partners

Request

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

Path parameters

Versionstring required

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

Pre-Verified-Phone-Number-IDstring required

Your Pre-Verified Phone Number ID. This ID is provided when the pre-verified phone number is created and can be found in your WhatsApp Business Account management interface.

Query parameters

fieldsstring

Comma-separated list of fields to include in the response. If not specified, default fields will be returned (id, name). Available fields: id, name, created_time, updated_time, verification_status, primary_page, timezone_id, two_factor_type

limitinteger

Maximum number of partner businesses to return per page. Default is 25, maximum is 100.

afterstring

Cursor for pagination. Use the 'after' cursor from a previous response to get the next page.

beforestring

Cursor for pagination. Use the 'before' cursor from a previous response to get the previous page.

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 partner businesses for the pre-verified phone number

Example response

{
  "data": [
    {
      "id": "1234567890123456",
      "name": "Partner Business Solutions Inc",
      "created_time": "2023-01-15T10:30:00Z",
      "updated_time": "2023-06-20T14:45:30Z",
      "verification_status": "verified",
      "primary_page": "9876543210987654",
      "timezone_id": 1,
      "two_factor_type": "admin_required"
    }
  ],
  "paging": {
    "cursors": {
      "before": "QVFIUjNpUWpVWmRBd0dn",
      "after": "QVFIUjNpUWpVWmRBd0Rn"
    },
    "previous": "https://graph.facebook.com/v23.0/1234567890/connected_client_businesses?before=QVFIUjNpUWpVWmRBd0Dn",
    "next": "https://graph.facebook.com/v23.0/1234567890/connected_client_businesses?after=QVFIUjNpUWpVWmRBd0Rn"
  }
}

Changes

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