---
title: "Get WhatsApp Account Number Details"
method: GET
path: "/{Version}/{WhatsApp-Account-Number-ID}"
tags: ["WhatsApp Account Numbers"]
---

# Get WhatsApp Account Number Details

`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

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.

## Path parameters

- `Version` string, required
- `WhatsApp-Account-Number-ID` string, required

## Query parameters

- `fields` string

## Headers

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

## Response `200`

Successfully retrieved WhatsApp Account Number details

- WhatsAppAccountNumber: WhatsApp Account Number details and configuration
  - `id` string, required: Unique identifier for the WhatsApp Account Number
  - `display_phone_number` string, required: Phone number in international format for display purposes
  - `verified_name` string: 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_code` string: ISO 3166-1 alpha-2 country code
  - `country_dial_code` string: 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
  - `certificate` string: Business certificate information for the account number
  - `is_official_business_account` boolean: Whether this is an official business account

## 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 - Account 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)