---
title: "Get Pre-Verified Phone Number Partners"
method: GET
path: "/{Version}/{Pre-Verified-Phone-Number-ID}/partners"
tags: ["Pre-Verified Phone Number Partners"]
---

# Get Pre-Verified Phone Number Partners

`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

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.

## Path parameters

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

## Query parameters

- `fields` string
- `limit` integer
- `after` string
- `before` string

## Headers

- `User-Agent` string
- `Authorization` string, required

## Response `200`

Successfully retrieved partner businesses for the pre-verified phone number

- WhatsAppBusinessPreVerifiedPhoneNumberPartnersResponse: Response containing partner businesses for a pre-verified phone number
  - `data` BusinessPartner[], required: List of partner businesses with access to the pre-verified phone number
    - `id` string, required: Unique identifier for the partner business
    - `name` string, required: Name of the partner business
    - `created_time` string, date-time: ISO 8601 timestamp when the business was created
    - `updated_time` string, date-time: ISO 8601 timestamp when the business was last updated
    - `verification_status` 'not_verified' | 'pending' | 'verified': Business verification status
    - `primary_page` string: Primary Facebook Page ID associated with the business
    - `timezone_id` integer: Timezone identifier for the business location
    - `two_factor_type` 'none' | 'admin_required': Two-factor authentication method configured for the business
  - `paging` CursorPaging: Cursor-based pagination information
    - `cursors` object
      - `before` string: Cursor pointing to the start of the page of data
      - `after` string: Cursor pointing to the end of the page of data
    - `previous` string: URL for the previous page of results
    - `next` string: URL for the next page of results

## Other responses

- `400`: Bad Request - Invalid parameters or malformed request
- `401`: Unauthorized - Invalid or missing access token
- `403`: Forbidden - Insufficient permissions or access denied
- `404`: Not Found - Pre-Verified Phone Number ID does not exist or is not accessible
- `422`: Unprocessable Entity - Request parameters are valid but cannot be processed
- `429`: Too Many Requests - Rate limit exceeded
- `500`: Internal Server Error - Unexpected server error

---

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