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

NameDescription
verified_nameThe verified name associated with the phone number.
display_phone_numberThe string representation of the phone number.
idThe ID associated with the phone number.
quality_ratingThe 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.

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