Phone Numbers

List the WhatsApp phone numbers attached to a WABA.


GET /api/v25.0/{WABA_ID}/phone_numbers
Authorization: Bearer pk_live_<your-key>

You authenticate with your Splashify partner API key. We resolve {WABA_ID} to the owning customer on your account and return its phone numbers. WABAs that don’t belong to your account return 403.

Customer-scoped alias

If you’d rather address the WABA by your internal customer_id, this alias does the same lookup for you:


GET /api/v1/partner/customers/{customer_id}/whatsapp/phone-numbers

Useful when you don’t yet know the WABA ID (e.g. between TP-Signup and the first whatsapp.waba_onboarded webhook).

Response — 200


{
  "data": [
    {
      "id": "1234567890875",
      "verified_name": "Acme Corp",
      "display_phone_number": "+91 70215 12345",
      "code_verification_status": "VERIFIED",
      "quality_rating": "GREEN",
      "platform_type": "CLOUD_API",
      "throughput": {
        "level": "HIGH"
      },
      "last_onboarded_time": "2023-08-31T10:55:37+0000"
    }
  ],
  "paging": {
    "cursors": {
      "before": "...",
      "after":  "..."
    }
  }
}

Field	Notes
`id`	The phone-number ID — use it as `{PHONE_NUMBER_ID}` in `/api/v25.0/{PHONE_NUMBER_ID}/messages`
`display_phone_number`	The customer-facing number
`verified_name`	The Meta-verified business name on this number
`code_verification_status`	`VERIFIED` or `NOT_VERIFIED`
`quality_rating`	`GREEN`, `YELLOW`, or `RED` — sustained `RED` triggers Meta’s quality-based sending limits
`throughput.level`	`HIGH` or `STANDARD`
`last_onboarded_time`	When the number was last registered with Meta

Errors

Status	Example
`401`	`{ "success": false, "message": "unauthorized" }`
`403`	`{ "success": false, "message": "id does not belong to your account" }`
`404`	`{ "success": false, "message": "id not found" }`
`502`	`{ "success": false, "message": "WhatsApp request failed. Try again shortly." }`
`503`	`{ "success": false, "message": "WhatsApp integration is not configured for your account. Contact support." }`

cURL


curl -X GET \
  "https://api.splashifypro.com/api/v25.0/$WABA_ID/phone_numbers" \
  -H "Authorization: Bearer $SPLASHIFY_API_KEY"

Notes

Quality rating. RED indicates Meta has flagged the number’s send behaviour. Pause marketing sends and reach support before resuming — this is the same signal Meta uses to throttle.