Get Phone Numbers

GET https://graph.facebook.com/{{Version}}/{{WABA-ID}}/phone_numbers

This API returns all phone numbers in a WhatsApp Business Account specified by the {{WABA-ID}} value. Get the id value for the phone number you want to use to send messages with WhatsApp Business Cloud API.

Response Parameters

Name Description
verified_name The verified name associated with the phone number.
display_phone_number The string representation of the phone number.
id The ID associated with the phone number.
quality_rating The quality rating of the phone number based on how messages have been received by recipients in recent days. Valid values are:
  • Green : High Quality
  • Yellow : Medium Quality
  • Red : Low Quality
  • NA : Quality has not been determined

For more information relating to quality rating, see About WhatsApp Business Account Message Quality Rating .

HEADERS

| Key | Datatype | Required | Description |

RESPONSES

status: OK

{"data":[{"verified_name":"Jasper's Market","display_phone_number":"+1 631-555-5555","id":"1906385232743451","quality_rating":"GREEN"},{"verified_name":"Jasper's Ice Cream","display_phone_number":"+1 631-555-5556","id":"1913623884432103","quality_rating":"NA"}]}