Skip to content

Check numbers before your Vapi agent dials

An AI voice agent that dials a dead number or a landline wastes call minutes and skews your results. Before your code asks Vapi to start an outbound call, send the number to the 1lookup.dev REST API and only dial the ones that pass your rules.

Step-by-step guide
HTTP request
curl -X POST https://api.1lookup.dev/v1/phone-validation \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"phone_number":"+15125550142"}'
[01/Setup]

Connect Vapi in 4 steps

You can also expose a lookup to the agent during a call. Where your agent is configured to call an HTTP endpoint as a tool, point that tool at a small endpoint of yours that calls 1lookup.dev and returns a short answer. Both pieces are code you host. 1lookup.dev has no component that runs inside Vapi.

  1. 1

    Create a 1lookup.dev API key and keep it on your server.

  2. 2

    In the job that queues outbound calls, POST each number to https://api.1lookup.dev/v1/phone-validation and filter on the response.

  3. 3

    Start the Vapi call only for numbers that passed.

  4. 4

    Optionally, add an HTTP tool to your agent that calls your own endpoint, which in turn calls 1lookup.dev.

[02/Recipes]

What to build with Vapi

Pre-dial validation

Run Phone Validation on every number in the queue and drop invalid numbers before the agent dials. Use line_type to decide which numbers are worth a call.

Do Not Call screening for outbound campaigns

Run DNC Scrub on US numbers before they enter the dialing queue and exclude flagged numbers according to your policy. This supports your compliance process and is not legal advice.

Verify an email the caller spells out

When the agent collects an email address, a tool call to Email Validation can confirm it is deliverable while the caller is still on the line.

Vapi is a trademark of its owner. This guide describes how to connect using our MCP server and REST API. 1lookup.dev is not affiliated with or endorsed by Vapi.

[ Validate ][ Enrich ]
[Get started]

Run your first lookup in two minutes

Create a key, pick a plan and call any product in the catalog. Plans start at $29 a month.

[ Screen ][ Scrape ]