lookup

Tells your agent whether a number is safe to call or text right now.

CommunityOnlineAPI key requiredGlobalFreeRead-only

What it can do

  • Vri Number Lookup: Live intelligence for ONE North American phone number: current carrier of record, line type, LRN routing data, porting activation date, and optionally caller-ID name (cnam), spam re
  • Vri Spam Check: Spam/scam/robocall reputation for one North American phone number.
  • Vri Bulk Status: Status and progress of a VRI bulk lookup job by job id.

What data it sees

Do you need an account

An API key from the service settings is required

Tells your agent whether a number is safe to call or text right now. Live reads of the U.S. and Canadian phone networks — carrier of record, line type, LRN, CNAM caller ID, spam/scam reputation, SMS deliverability, and a TCPA 8 a.m.–9 p.m. calling-window verdict — plus bulk lookups. Every query gets a fresh dip, never stale cached data. Free sandbox key, no card required. Pay per lookup with no minimums.

Server tool list (5)

Raw names from tools/list. Only developers need these.

vri_number_lookupLive intelligence for ONE North American phone number: current carrier of record, line type, LRN routing data, porting activation date, and optionally caller-ID name (cnam), spam reputation, and messaging provider. Always a fresh read of live numbering infrastructure — never cached carrier data.
vri_spam_checkSpam/scam/robocall reputation for one North American phone number.
vri_bulk_statusStatus and progress of a VRI bulk lookup job by job id.
vri_bulk_lookupLive lookup for up to 100 North American phone numbers in one call (carrier, line type, routing; optional cnam/spam/messaging). Each number is a fresh paid read — spend scope required.
vri_submit_jobSubmit an ASYNC bulk lookup job for up to 10000 North American phone numbers. Balance is reserved up front and the job runs in the background; check progress with vri_bulk_status. Requires a customer API key (jobs bill the account that owns the key).