VoiceTel

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
cnam.shGET /v2.2/cnam/{number} 
curl -X GET 'https://api.voicetel.com/v2.2/cnam/2025551234' \
  -H 'Authorization: Bearer YOUR_API_KEY'

Caller Lookup

CNAM and caller-ID data before the conversation begins.

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. It returns the Caller ID Name registered for the given 10-digit number. Billed per lookup; requires CNAM service to be enabled.

Full reference: VoiceTel API v2.2 › CNAM lookup.

Caller Lookup overview
Returns
CNAM
Caller ID Name registered for the number
Input
10digits
e.g. 2025551234
Billing
Per lookup
Requires CNAM service enabled
Sample result
VOICETEL
cnam for 2025551234

Caller Lookup 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.

Carrier Lookup

LRN, portability, and carrier-of-record context for routing and rating.

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.

Full reference: VoiceTel API v2.2 › LRN lookup.

Carrier Lookup overview
  • LRNlocation routing number Returned
  • Mobile portabilityported-number context Returned
  • Carrier of recordOCN and state Returned
  • Jurisdiction and LATAcomputed from destination and ANI Returned
  • Inputsdestination number, then calling ANI Both required

Carrier Lookup 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.

Make smarter decisions before the call connects.

Caller identity plus carrier-of-record context, queried in real time or in batch. Once you have an API key, run cnamLookup and lrnLookup live from the browser in the API playground; the key stays encrypted to your device, never readable from the page.

Try for free Open the playground

Trusted by