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
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"}}}