MEmeta
WhatsApp Account Numbers

Get WhatsApp Account Number Details

Retrieve comprehensive details about a WhatsApp Account Number, including its current status, verification information, quality rating, and configuration settings.

Use Cases:

  • Monitor account number status and quality rating
  • Verify account number configuration before messaging operations
  • Check verification and approval status
  • Retrieve display name and business profile information

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

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

get/{Version}/{WhatsApp-Account-Number-ID}

Request

  • Base URL
    https://graph.facebook.com
  • URL
    https://graph.facebook.com/{Version}/{WhatsApp-Account-Number-ID}
  • Auth
    HTTP bearer

Path parameters

Versionstring required

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

WhatsApp-Account-Number-IDstring required

Your WhatsApp Account Number ID. This ID represents the account number entity and can be obtained from your WhatsApp Business Account phone numbers list.

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, status). Available fields: id, display_phone_number, verified_name, status, quality_rating, country_code, country_dial_code, code_verification_status, name_status, messaging_limit_tier, account_mode, certificate, is_official_business_account

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 WhatsApp Account Number details

idstring required

Unique identifier for the WhatsApp Account Number

display_phone_numberstring required

Phone number in international format for display purposes

verified_namestring

Business name verified for this phone number

status'CONNECTED' | 'DISCONNECTED' | 'UNVERIFIED' | 'PENDING' | 'FLAGGED' | 'RESTRICTED' required

Current status of the WhatsApp Account Number

quality_rating'GREEN' | 'YELLOW' | 'RED' | 'NA'

Quality rating based on message delivery and user feedback

country_codestring

ISO 3166-1 alpha-2 country code

country_dial_codestring

Country dialing code

code_verification_status'VERIFIED' | 'UNVERIFIED'

Two-step verification status for the phone number

name_status'APPROVED' | 'AVAILABLE_WITHOUT_REVIEW' | 'DECLINED' | 'EXPIRED' | 'PENDING_REVIEW' | 'NONE'

Status of the display name associated with the phone number

messaging_limit_tier'TIER_50' | 'TIER_250' | 'TIER_1K' | 'TIER_10K' | 'TIER_100K' | 'TIER_UNLIMITED'

Current messaging limit tier for the account number

account_mode'LIVE' | 'SANDBOX'

Account mode indicating sandbox or live environment

certificatestring

Business certificate information for the account number

is_official_business_accountboolean

Whether this is an official business account

Example response

{
  "id": "1234567890123456",
  "display_phone_number": "+1 631-555-5555",
  "verified_name": "Jasper's Market",
  "status": "CONNECTED",
  "quality_rating": "GREEN",
  "country_code": "US",
  "country_dial_code": "1",
  "code_verification_status": "VERIFIED",
  "name_status": "AVAILABLE_WITHOUT_REVIEW",
  "messaging_limit_tier": "TIER_1K",
  "account_mode": "LIVE",
  "certificate": "certificate_data_placeholder"
}

Changes

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