Skip to main content
POST
/
v1
/
introspect
/
phone
Introspect Phone
curl --request POST \
  --url https://api.zavu.dev/v1/introspect/phone \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "phoneNumber": "<string>"
}'
{
  "phoneNumber": "+56912345678",
  "countryCode": "CL",
  "carrier": {
    "name": "Entel PCS",
    "type": "mobile"
  },
  "availableChannels": ["sms", "whatsapp"]
}
Retrieve information about a phone number including carrier details and available messaging channels.

Request

phoneNumber
string
required
Phone number in E.164 format (e.g., +56912345678)

Response

phoneNumber
string
The queried phone number
countryCode
string
ISO 3166-1 alpha-2 country code
carrier
object
Carrier information
availableChannels
array
Channels available for this number: sms, whatsapp, etc.
{
  "phoneNumber": "+56912345678",
  "countryCode": "CL",
  "carrier": {
    "name": "Entel PCS",
    "type": "mobile"
  },
  "availableChannels": ["sms", "whatsapp"]
}

Example

curl -X POST https://api.zavu.dev/v1/introspect/phone \
  -H "Authorization: Bearer zv_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "phoneNumber": "+56912345678"
  }'

Use Cases

  • Pre-send validation: Check if a number can receive messages
  • Channel selection: Determine which channels are available
  • Cost estimation: Identify carrier for pricing purposes
  • Fraud prevention: Verify line type (mobile vs VoIP)
Phone introspection uses carrier lookup services and may incur additional costs. Results are cached for 24 hours.