Phone Numbers
GET https://graph.facebook.com/{{Version}}/{{Assigned-WABA-ID}}/phone_numbers
Use this endpoint to get the phone numbers associated with a WhatsApp Business Account (WABA).
Parameters
| Name | Description |
|---|---|
display_phone_number
| Phone number. |
name_status
|
The review status of the current display name request. Available status options are:
APPROVED
,
DECLINED
,
EXPIRED
,
PENDING_REVIEW
, and
NONE
|
certificate
| Returns the current certificate for that phone number. |
new_certificate
| The certificate of a new display name, after a display name change has been approved. This field returns data only if a display name change request was approved and is available until the phone number has been registered with the new certificate. |
new_name_status
| The review status of a display name change request. This field returns data only if a display name change was requested. |
filtering
|
Used to filter phone numbers. See
filtering
object for details.
|
The
filtering
Object
| Name | Description |
|---|---|
field
|
Contains the field being used for filtering. Currently, the supported value is
account_mode
.
|
operator
|
Contains how you want to filter the accounts. Currently, the supported value is
EQUAL
.
|
value
|
Contains what account mode you are looking for. Supported Values:
SANDBOX
,
LIVE
|
Examples
Under
Example Request
on the right-side panel, you can switch between examples of the following API calls:
- Fetch phone number status and certificate
- Filter phone numbers by
account_mode
HEADERS
| Key | Datatype | Required | Description |
RESPONSES
status: OK
{"data":[{"id":"1972385232742141","display_phone_number":"+1 631-555-1111","verified_name":"John’s Cake Shop","quality_rating":"UNKNOWN"}],"paging":{"cursors":{"before":"abcdefghij","after":"klmnopqr"}}}