Skip to content

Cleaner call lists for Retell AI agents

Retell AI agents place and receive calls on your behalf, and they work from the numbers you give them. Run those numbers through the 1lookup.dev REST API first. A bulk upload handles a whole campaign list, and a single API call handles a number that arrives in real time.

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

Connect Retell AI in 4 steps

During a call, an agent can use a custom function that requests data from a URL you provide. Host a small endpoint that forwards the request to 1lookup.dev and returns only the fields the agent needs. This is your integration, written against two public APIs. We do not ship anything that installs into Retell AI.

  1. 1

    Create a dedicated 1lookup.dev API key for your calling pipeline.

  2. 2

    Export your campaign list as CSV and run it through bulk upload, or call https://api.1lookup.dev/v1/{product-slug} per number from your backend.

  3. 3

    Load only the numbers that passed into your Retell AI campaign.

  4. 4

    For in-call lookups, host an endpoint that calls 1lookup.dev and register its URL as a custom function for the agent.

[02/Recipes]

What to build with Retell AI

Remove unreachable mobiles before a campaign

Bulk upload the campaign list to HLR Lookup and keep the numbers the network reports as reachable.

Route by line type

Check each inbound lead with Phone Validation and send mobiles to the voice agent with an SMS follow-up, and landlines to a call-only flow.

Review calls from transcripts

Send finished call recordings to Audio Transcription and review the text for calls that ended early or went off script.

Retell AI 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 Retell AI.

[ 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 ]