For developers / Lookups

Enrich your application with caller and carrier intelligence.

VoiceTel's lookup services help developers make smarter decisions before a call is answered, routed, rated, or risk-scored. Combine caller identity and carrier routing data into screen pops, fraud checks, and rating workflows.

Start building API documentation

Caller Lookup

Caller Lookup enriches phone numbers with CNAM and caller-ID information so applications can display caller names, inform routing decisions, screen inbound traffic, or prepare CRM screen pops before a conversation begins. Returns the Caller ID Name registered for the given 10-digit number. Billed per lookup; requires CNAM service to be enabled.

Use cases

  • Agent screen pops

    Display caller identity before the conversation starts.

  • Inbound screening

    Use caller identity as one signal in spam, fraud, and escalation decisions.

  • Routing context

    Route known business callers, customers, anonymous callers, or high-priority contacts into different workflows.

  • Batch hygiene

    Clean lists before campaigns, migrations, or CRM updates.

Request

curl -X GET 'https://api.voicetel.com/v2.2/cnam/2025551234' \
  -H 'Authorization: Bearer YOUR_API_KEY'

Response

{
  "status": "success",
  "data": {
    "number": "2025551234",
    "cnam": "VOICETEL"
  }
}

Carrier Lookup

Carrier Lookup returns routing intelligence such as LRN, mobile portability, and carrier-of-record context. Use that data during signup, fraud checks, call setup, support workflows, or routing decisions. The path takes the destination number followed by the calling ANI; both are required to compute jurisdiction and LATA correctly.

Use cases

  • Real-time call setup

    Query numbers before routing traffic.

  • Fraud and risk checks

    Compare carrier and portability signals against user behavior.

  • Support troubleshooting

    Give operations teams a portal-based lookup path for manual investigation.

  • Routing and rating decisions

    Use carrier-of-record and portability signals as inputs to telecom workflows.

Request

curl -X GET 'https://api.voicetel.com/v2.2/lrn/2025551234/4155550100' \
  -H 'Authorization: Bearer YOUR_API_KEY'

Response

{
  "status": "success",
  "data": {
    "destination": "2025551234",
    "ani": "4155550100",
    "lrn": {
      "LRN": "12125550000",
      "STATE": "NY",
      "JURISDICTION": "INTERSTATE",
      "LOCAL": "N",
      "LATA": "132",
      "OCN": "9101",
      "CITY": "NEW YORK"
    }
  }
}