---
title: "Retrieve WhatsApp Business Phone Number Information"
method: GET
path: "/{Version}/{Phone-Number-ID}"
tags: ["Phone Numbers"]
---

# Retrieve WhatsApp Business Phone Number Information

`GET /{Version}/{Phone-Number-ID}`

## Request

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

Retrieve comprehensive information about a WhatsApp Business phone number using its unique ID (CSID).
This endpoint provides phone number status, verification details, quality metrics, and configuration information.

**Core Information Returned:**
- Phone number ID and display format
- Verification status and verified business name
- Quality rating based on message delivery performance
- Code verification status for two-step verification
- Display name certification status (when requested)

**Quality Rating System:**
The quality rating reflects how recipients have been receiving messages from this phone number:
- **GREEN**: High quality - messages are being delivered and engaged with well
- **YELLOW**: Medium quality - some delivery or engagement issues detected
- **RED**: Low quality - significant delivery or engagement problems
- **NA**: Quality rating not yet determined (new phone numbers)

**Display Name Status:**
When requesting the `name_status` field, you'll receive the current verification status:
- **APPROVED**: Business display name has been verified and is ready to use
- **AVAILABLE_WITHOUT_REVIEW**: Display name is ready to use without additional review
- **DECLINED**: Business display name verification was rejected
- **EXPIRED**: Display name approval has expired
- **PENDING_REVIEW**: Display name verification request is under review
- **NONE**: No display name verification request exists

**Code Verification Status:**
Indicates the two-step verification status:
- **VERIFIED**: Phone number has completed two-step verification
- **UNVERIFIED**: Two-step verification is pending or incomplete

**Use Cases:**
- Monitor phone number quality and delivery performance
- Check verification and display name status
- Validate phone number configuration before sending messages
- Retrieve display information for business profiles
- Audit phone number compliance and status

For more information on quality ratings, see [WhatsApp Business Account Message Quality Rating](https://www.facebook.com/business/help/896873687365001).

## Path parameters

- `Version` string, required
- `Phone-Number-ID` string, required

## Query parameters

- `fields` string

## Headers

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

## Response `200`

Successfully retrieved phone number information. The response includes core phone number details
and any additional fields requested via the `fields` parameter.

- PhoneNumberInfo: Phone number information and status
  - `id` string: The ID associated with the phone number
  - `display_phone_number` string: The string representation of the phone number
  - `verified_name` string: The verified name associated with the phone number
  - `quality_rating` 'GREEN' | 'YELLOW' | 'RED' | 'NA': The quality rating of the phone number based on how messages have been received by recipients in recent days. - GREEN: High Quality - YELLOW: Medium Quality - RED: Low Quality - NA: Quality has not been determined
  - `code_verification_status` 'VERIFIED' | 'UNVERIFIED': The two-step verification status for the phone number indicating whether the number has completed two-step verification. - VERIFIED: Phone number has completed two-step verification - UNVERIFIED: Two-step verification is pending or incomplete
  - `name_status` 'APPROVED' | 'AVAILABLE_WITHOUT_REVIEW' | 'DECLINED' | 'EXPIRED' | 'PENDING_REVIEW' | 'NONE': The status of a display name associated with a specific phone number. - APPROVED: The display name has been approved and is ready to use. - AVAILABLE_WITHOUT_REVIEW: The display name is ready to use without review. - DECLINED: The display name has not been approved. - EXPIRED: The display name approval has expired. - PENDING_REVIEW: The display name is under review. - NONE: No display name verification request exists.

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