Phone Number Details

Detailed status for one phone number. Use Phone Numbers to list them all; this endpoint zooms in on one.


GET /api/v25.0/{PHONE_NUMBER_ID}?fields=status,is_official_business_account,id,name_status,code_verification_status,display_phone_number,platform_type,messaging_limit_tier,throughput
Authorization: Bearer pk_live_<your-key>

The {PHONE_NUMBER_ID} must belong to a customer under your partner account — IDs that resolve elsewhere return 403.

Customer-scoped alias


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

Same response. Use whichever shape fits your data model.

Fields

If you don’t pass a fields= query, Meta returns its default set. The canonical list of useful fields is:


status, is_official_business_account, id, name_status, code_verification_status,
display_phone_number, platform_type, messaging_limit_tier, throughput

Trim by passing only what you need.

Response — 200


{
  "status":                       "CONNECTED",
  "is_official_business_account": true,
  "id":                           "112269058640637",
  "name_status":                  "APPROVED",
  "code_verification_status":     "EXPIRED",
  "display_phone_number":         "+91 70215 12345",
  "platform_type":                "CLOUD_API",
  "throughput":                   { "level": "HIGH" }
}

Field	Notes
`status`	`CONNECTED` / `DISCONNECTED` / `PENDING`
`is_official_business_account`	True once Meta verifies the business
`name_status`	`APPROVED` / `PENDING_REVIEW` / `DECLINED`
`code_verification_status`	`VERIFIED` / `NOT_VERIFIED` / `EXPIRED`
`platform_type`	`CLOUD_API` (we don’t support on-prem)
`messaging_limit_tier`	Returned when `whatsapp_business_manager_messaging_limit,messaging_limit_tier` is in `fields=`; see Messaging Limit
`throughput.level`	`HIGH` / `STANDARD`

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." }`

cURL


curl -X GET \
  "https://api.splashifypro.com/api/v25.0/$PHONE_NUMBER_ID?fields=status,is_official_business_account,id,name_status,code_verification_status,display_phone_number,platform_type,messaging_limit_tier,throughput" \
  -H "Authorization: Bearer $SPLASHIFY_API_KEY"