MEmeta
Pre-Verified Phone Numbers

Get Pre-Verified Phone Numbers

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.

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

Path parameters

Versionstring required

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

Business-IDstring required

Your Business ID for which to retrieve pre-verified phone numbers. This ID can be found in your Meta Business Manager or through business management APIs.

Query parameters

fieldsstring

Comma-separated list of fields to include in the response. If not specified, default fields will be returned (id, display_phone_number, verification_status). Available fields: id, display_phone_number, country_prefix, verification_status, availability_status, created_time, last_updated, supported_features, country_code, region

limitinteger

Maximum number of phone numbers to return per page. Default is 25, maximum is 100.

afterstring

Cursor for pagination. Use this to retrieve the next page of results. This value is provided in the 'paging' object of previous responses.

beforestring

Cursor for pagination. Use this to retrieve the previous page of results. This value is provided in the 'paging' object of previous responses.

verification_status'VERIFIED' | 'PENDING' | 'FAILED' | 'EXPIRED'

Current verification status of the pre-verified phone number

Example:VERIFIED

Filter results by verification status. Only phone numbers with the specified verification status will be returned.

availability_status'AVAILABLE' | 'IN_USE' | 'RESERVED' | 'UNAVAILABLE'

Current availability status of the pre-verified phone number

Example:AVAILABLE

Filter results by availability status. Only phone numbers with the specified availability status will be returned.

country_codestring

Filter results by country code. Only phone numbers from the specified country will be returned. Use ISO 3166-1 alpha-2 country codes.

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 pre-verified phone numbers

Example response

{
  "data": [
    {
      "id": "1234567890123456",
      "display_phone_number": "+1 (555) 123-4567",
      "country_prefix": 1,
      "verification_status": "VERIFIED",
      "availability_status": "AVAILABLE",
      "created_time": "2024-01-15T10:30:00Z",
      "last_updated": "2024-01-20T14:45:00Z",
      "supported_features": [
        "MESSAGING",
        "BUSINESS_PROFILE",
        "WEBHOOKS"
      ],
      "country_code": "US",
      "region": "North America"
    }
  ],
  "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.