Check phone connectivity API
/phone_ping
Tests the connectivity of one or more supplied phone numbers (Connected, Disconnected, Undetermined, Invalid).
Example Request
GET{
"phones": "0417034325",
"timeout": 60
}
Available Response Data
- check_circle Batch Processing Message Status
- check_circle Array of Analysed Phone Numbers
- check_circle Live Ping Results (Connected, Disconnected, Undetermined, Invalid)
- check_circle Telecommunications Carrier Information (where available)
Request Schema
| Field Name | Type | Required | Description |
|---|---|---|---|
| phones | string | Yes | One or more comma-separated 10 digit Australian phone numbers. |
| timeout | integer | No | Maximum seconds to wait. |
Technical Use Cases
Call Centre Optimisation
Scrub lead lists prior to dialling to instantly remove disconnected (D) or invalid (I) numbers, drastically reducing agent idle time.
SMS Routing Integrity
Ensure SMS authentication codes (2FA) are only sent to active, connected phone numbers to save on messaging costs.
Webhooks & Events
ping-batch-resolved
Emitted when a large comma-separated list of numbers finishes processing against the live carrier networks.
Compliance & Security
Common Questions
Everything you need to know about implementation details and compliance infrastructure.
help_center General
What does the "U" (Undetermined) status mean?
add
What does the "U" (Undetermined) status mean?
Occasionally, a carrier network will time out or refuse a ping request. A “U” result means the number is formatted correctly, but the live connection state could not be guaranteed at that exact millisecond.