---
title: "Get WhatsApp Business Account Phone Numbers"
method: GET
path: "/{Version}/{WABA-ID}/phone_numbers"
tags: ["Phone Number Management"]
---

# Get WhatsApp Business Account Phone Numbers

`GET /{Version}/{WABA-ID}/phone_numbers`

## Request

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

Retrieve all phone numbers associated with a WhatsApp Business Account, including their
status, verification details, and configuration information.

**Use Cases:**
- List all phone numbers in a WhatsApp Business Account
- Monitor phone number status and verification progress
- Check phone number quality ratings and messaging limits
- Retrieve phone number configuration details

**Filtering:**
You can filter results using the `filtering` parameter with JSON-encoded filter conditions.
Supported filters include account_mode, messaging_limit_tier, and is_official_business_account.

**Sorting:**
Results can be sorted by creation_time or last_onboarded_time in ascending or descending order.

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

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

## Path parameters

- `Version` string, required
- `WABA-ID` string, required

## Query parameters

- `fields` string
- `filtering` string
- `sort` 'creation_time.asc' | 'creation_time.desc' | 'last_onboarded_time.asc' | 'last_onboarded_time.desc'
- `limit` integer
- `after` string
- `before` string

## Headers

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

## Response `200`

Successfully retrieved WhatsApp Business Account phone numbers

- WhatsAppBusinessAccountPhoneNumbersConnection: Paginated collection of WhatsApp Business Account phone numbers
  - `data` WhatsAppBusinessAccountPhoneNumber[], required: Array of phone number records
    - `id` string, required: Unique identifier for the phone number status record
    - `display_phone_number` string, required: Phone number in international format for display purposes
    - `verified_name` string: Business name verified for this phone number
    - `status` 'PENDING' | 'LINKED' | 'UNLINKED' | 'DELETED' | 'MIGRATED' | 'BANNED' | 'RESTRICTED', required: Current status of the phone number in the WhatsApp Business Account
    - `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
    - `unified_cert_status` 'APPROVED' | 'NAME_PENDING_REVIEW' | 'NAME_NOT_APPROVED' | 'ACCOUNT_REVIEW_NOT_STARTED' | 'LIMITED_ACCESS': Unified certification status combining business and name verification
    - `account_mode` 'LIVE' | 'SANDBOX': Account mode indicating sandbox or live environment
    - `host_platform` 'CLOUD_API' | 'ON_PREMISE' | 'NOT_APPLICABLE': Platform hosting the WhatsApp Business Account
    - `messaging_limit_tier` 'TIER_50' | 'TIER_250' | 'TIER_1K' | 'TIER_10K' | 'TIER_100K' | 'TIER_UNLIMITED': Current messaging limit tier for the phone number
    - `is_official_business_account` boolean: Whether this is an official business account
    - `username` string, nullable: WhatsApp username for the business account (if available)
  - `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 - WhatsApp Business Account 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)