Phone Numbers

The WhatsApp Business Management API does not currently allow associating new phone numbers with a WhatsApp Business Account. This endpoint only allows reading information about phones registered.

All Phone Numbers

Reading all the phone numbers belonging to a WhatsApp Business Account.

Request

curl -X GET \
'https://graph.facebook.com/v3.3/your-whatsapp-business-account-id/phone_numbers' \
  -d 'access_token=your-access-token'

Response

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

Single Phone Number

When you query all the phone numbers for a WhatsApp Business Account, each phone number has an id. You can directly query for a phone number using this id.

Request

curl -X GET \
'https://graph.facebook.com/v3.3/phone-number-id' \
  -d 'access_token=your-access-token'

Response

{
  "verified_name": "Jasper's Market",
  "display_phone_number": "+1 631-555-5555",
  "id": "1906385232743451",
  "quality_rating": "GREEN"
}

Reference

For a list of all possible values for each field, refer to the Graph API reference of the Phone Number field.