look up carrier and reachability data with the Vonage Number Insight API
domain: developer.vonage.com · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
Steps
Call the Basic endpoint for formatting/validation only, when you just need a normalized national/international number.
Call the Standard endpoint to additionally get number type and current mobile carrier (plus US caller-identity where available).
Call the Advanced endpoint (sync or async/webhook-based) for the fullest data set, including roaming and reachability status.
For Advanced Async, supply a callback URL and correlate responses via the request ID rather than polling.
Cache results per number where your use case tolerates staleness, since each tier is billed per lookup.
Known gotchas
Vonage has announced it will sunset Number Insight (effective February 4, 2027) in favor of the newer Identity Insights API — new integrations should evaluate Identity Insights rather than building fresh dependencies on the API being sunset.
The three tiers (Basic/Standard/Advanced) are additive in data but not in latency — Advanced, particularly in async mode, can be meaningfully slower and shouldn't be called synchronously in a user-facing hot path.
Give your agent this knowledge — and 15,500+ more routes
One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp
Need this verified for your stack — or a route we don't have yet?