---
title: "Get Pre-Verified Phone Numbers"
method: GET
path: "/{Version}/{Business-ID}/preverified_numbers"
tags: ["Pre-Verified Phone Numbers"]
---

# Get Pre-Verified Phone Numbers

`GET /{Version}/{Business-ID}/preverified_numbers`

## Request

- Base URL: `https://graph.facebook.com`
- URL: `https://graph.facebook.com/{Version}/{Business-ID}/preverified_numbers`
- Auth: HTTP bearer

Retrieve pre-verified phone numbers available for use with the specified business.
This endpoint provides information about phone numbers that have been pre-verified
and are ready for immediate use with WhatsApp Business messaging operations.

**Use Cases:**
- Retrieve available pre-verified phone numbers for business messaging setup
- Check verification status and availability of phone numbers
- Monitor pre-verified phone number inventory
- Validate phone number options before WhatsApp Business Account configuration
- Facilitate quick business messaging setup with pre-verified numbers

**Filtering and Pagination:**
- Results can be filtered by verification status, availability, and country
- Cursor-based pagination is supported for large result sets
- Default page size is 25 items, maximum is 100 items per page

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

**Caching:**
Phone number information can be cached for short periods, but availability status
may change frequently. Implement appropriate cache invalidation strategies.

## Path parameters

- `Version` string, required
- `Business-ID` string, required

## Query parameters

- `fields` string
- `limit` integer
- `after` string
- `before` string
- `verification_status` 'VERIFIED' | 'PENDING' | 'FAILED' | 'EXPIRED': Current verification status of the pre-verified phone number
- `availability_status` 'AVAILABLE' | 'IN_USE' | 'RESERVED' | 'UNAVAILABLE': Current availability status of the pre-verified phone number
- `country_code` string

## Headers

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

## Response `200`

Successfully retrieved pre-verified phone numbers

- PreVerifiedPhoneNumbersResponse: Response containing list of pre-verified phone numbers
  - `data` PreVerifiedPhoneNumber[], required: List of pre-verified phone numbers
    - `id` string, required: Unique identifier for the pre-verified phone number
    - `display_phone_number` string, required: Formatted display version of the phone number
    - `country_prefix` integer: Country code prefix for the phone number
    - `verification_status` 'VERIFIED' | 'PENDING' | 'FAILED' | 'EXPIRED', required: Current verification status of the pre-verified phone number
    - `availability_status` 'AVAILABLE' | 'IN_USE' | 'RESERVED' | 'UNAVAILABLE': Current availability status of the pre-verified phone number
    - `created_time` string, date-time: Timestamp when the phone number was pre-verified
    - `last_updated` string, date-time: Timestamp when the phone number information was last updated
    - `supported_features` WhatsAppBusinessFeature[]: List of WhatsApp Business features supported by this phone number
    - `country_code` string: ISO 3166-1 alpha-2 country code for the phone number
    - `region` string: Geographic region or area for the phone number
  - `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 - Business 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)