MEmeta
Pre-Verified Phone Numbers

Get Pre-Verified Phone Number Details

Retrieve details about a specific pre-verified phone number, including validation status, formatting information, and any associated error messages.

Use Cases:

  • Check validation status of a pre-verified phone number
  • Retrieve formatted display version of the phone number
  • Get country code and formatting information
  • Troubleshoot validation errors

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

Caching: Phone number details can be cached for moderate periods, but validation status may change. Implement appropriate cache invalidation strategies.

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

Request

  • Base URL
    https://graph.facebook.com
  • URL
    https://graph.facebook.com/{Version}/{Pre-Verified-Phone-Number-ID}
  • 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

The pre-verified phone number ID to retrieve details for. This ID is provided by your Business Solution Provider (BSP) during the pre-verification process.

Query parameters

fieldsstring

Comma-separated list of fields to include in the response. If not specified, default fields will be returned (id, is_input_id_valid). Available fields: id, country_prefix, display_phone_number, error_msg, is_input_id_valid

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 number details

idstring

Unique identifier for the pre-verified phone number

country_prefixinteger

Country code prefix for the phone number

display_phone_numberstring

Formatted display version of the phone number

error_msgstring

Error message if validation failed

is_input_id_validboolean required

Whether the provided phone number ID is valid

Example response

{
  "id": "1234567890123456",
  "country_prefix": 1,
  "display_phone_number": "+1 (555) 123-4567",
  "error_msg": "Phone number format is invalid",
  "is_input_id_valid": true
}

Changes

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