Caller Lookup
Caller-name data for routing, display, and screening.
Caller Lookup gives applications and operators a way to enrich phone numbers with CNAM and caller-ID information before a call is answered, routed, or presented to an agent.
curl -X POST https://api.voicetel.com/v2.1/info/cnam/ \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"apikey": "YOUR_API_KEY",
"cid": 2015551234
}'
Why CNAM
CNAM-enriched lookup, not just LERG.
A LERG-only lookup tells you which carrier the number routes through. CNAM tells you the business name on the caller-ID record, which is what the agent or the application actually needs. VoiceTel blends CNAM, LERG, and portability data into a single query so you don't have to make three calls per inbound.
Full reference: VoiceTel API v2.2 › CNAM lookup.
- CNAM Included
- LERG Included
- Portability Included
- Queries per inbound call 1
Use cases
-
Agent screen pop
Display a caller name in CRM or helpdesk workflows 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, or anonymous callers into different queues or workflows.
-
Batch hygiene
Run lists through batch lookup before a campaign, migration, or data-cleanup project.
Run 100 numbers through it.
Send a batch of test numbers through the API. See the data quality, latency, and unit cost on your own real numbers before integrating.

