List phone numbers

The business's official WhatsApp (Cloud API) numbers. id is the channel_uuid of POST /messages/send, and number is the from_phone_number of POST /send-template.

GET/phone-numbers

Authentication

This endpoint authenticates with your API key sent in the X-API-Key header (ek_live_... format). You can create it in Business settings → API Keys.

Example request

bash
curl -X GET "https://api.eclecticlabs.com/api/external/v2/phone-numbers" \
  -H "X-API-Key: ek_live_your_api_key_here"

Example response

json
{
  "phone_numbers": [
    {
      "id": "3b7e8d21-4c5f-4a90-8e12-6f0a1b2c3d4e",
      "number": "56912345678",
      "display_name": "Mi Tienda",
      "alias": "Ventas",
      "status": "CONNECTED",
      "quality_rating": "GREEN",
      "can_send": true,
      "connection_issue": null,
      "whatsapp_account_id": "c0a8012e-7d3b-4f6a-9c21-5e4d3b2a1f00"
    }
  ]
}

status and quality_rating are Meta's, as of the last refresh. can_send is false when the number cannot send right now, and connection_issue says why.