Reverse phone number lookup — carrier, caller name, line type, SIM swap detection.

Phone Lookup

Reverse lookup any phone number to get carrier info, caller name, line type, SIM swap detection, and more. Powered by Twilio Lookup v2.

POST /api/v1/lookup

Auth: x402 payment ($0.05 USDC)

Parameters

Parameter	Type	Required	Description
`phoneNumber`	string	Yes	Phone number (E.164 format)
`fields`	string[]	No	Lookup fields to request (defaults to `line_type_intelligence`, `caller_name`)

Available Fields

Field	Description
`line_type_intelligence`	Line type (mobile, landline, VoIP), carrier name
`caller_name`	Registered caller name (CNAM)
`line_status`	Current line status (active, inactive, etc.)
`sim_swap`	SIM swap detection — last swap date, carrier
`identity_match`	Identity verification against name/address
`reassigned_number`	Whether number was recently reassigned
`sms_pumping_risk`	SMS pumping fraud risk score
`phone_number_quality_score`	Number quality/reputation score

Example Request (cURL)

curl -X POST https://x402.dial.wtf/api/v1/lookup \
  -H "Content-Type: application/json" \
  -H "Payment-Signature: BASE64_ENCODED_PAYMENT" \
  -d '{
    "phoneNumber": "+1234567890",
    "fields": ["line_type_intelligence", "caller_name", "sim_swap"]
  }'

Example Request (JavaScript)

const result = await dial.lookup.phone({
  phoneNumber: "+1234567890",
  fields: ["line_type_intelligence", "caller_name", "sim_swap"],
});

Response

{
  "success": true,
  "message": "Lookup complete",
  "provider": "twilio",
  "phoneNumber": "+1234567890",
  "countryCode": "US",
  "nationalFormat": "(234) 567-890",
  "valid": true,
  "validationErrors": [],
  "data": {
    "line_type_intelligence": {
      "type": "mobile",
      "carrier": "T-Mobile"
    },
    "caller_name": {
      "caller_name": "John Doe",
      "caller_type": "CONSUMER"
    },
    "sim_swap": {
      "last_sim_swap": {
        "last_sim_swap_date": "2025-01-15T00:00:00Z",
        "swapped_period": "PT8760H",
        "swapped_in_period": false
      }
    }
  }
}

POST /api/v1/lookup/with-credits

Auth: Bearer token (1 credit)

Same parameters and response. Uses prepaid credits instead of x402 payment.

curl -X POST https://x402.dial.wtf/api/v1/lookup/with-credits \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_PRIVY_ACCESS_TOKEN" \
  -d '{"phoneNumber": "+1234567890"}'

Phone Lookup

On this page