Skip to main content
GET
/
{business_account_id}
/
phone_numbers
List phone numbers
curl --request GET \
  --url https://api.kapso.ai/meta/whatsapp/v24.0/{business_account_id}/phone_numbers \
  --header 'X-API-Key: <api-key>'
{
  "data": [
    {
      "id": "1906385232743451",
      "verified_name": "Jasper's Market",
      "display_phone_number": "+1 631-555-5555",
      "quality_rating": "GREEN"
    },
    {
      "id": "1913623884432103",
      "verified_name": "Jasper's Ice Cream",
      "display_phone_number": "+1 631-555-5556",
      "quality_rating": "NA"
    }
  ]
}

Authorizations

​
X-API-Key
string
header
required

Project API key for authentication. This is the recommended authentication method.

Get your API key from the Kapso dashboard under Project Settings > API Keys.

Path Parameters

​
business_account_id
string
required

WhatsApp Business Account ID

Query Parameters

​
fields
string

Comma-separated list of fields to retrieve.

Available fields: id, verified_name, display_phone_number, quality_rating, code_verification_status, is_official_business_account, name_status, new_name_status, platform_type, throughput, account_mode, certificate, messaging_limit_tier

Response

Phone numbers retrieved successfully

​
data
object[]
​
paging
object