Skip to content
[FAQ]

Questions, answered plainly

32 answers about the product, credits, the API, AI agents and data. If yours is not here, write to 1lookup@volods.com.

Product

What is 1lookup.dev?

1lookup.dev is a data lookup API and dashboard. One API key and one credit balance give you access to 79 products for validating and enriching contact, company and network data. You can call the API from code, upload a CSV in the dashboard, or connect an AI agent through the MCP server.

What do the 79 products cover?

They cover phone, email and IP validation, contact and company enrichment, public registries and compliance lists, social data, search and SEO data, website scraping and audio transcription. Each product has its own page with the input fields, the response fields and the credit cost.

How are results returned?

Every request returns JSON in the same envelope. The product's output sits in a data object, and a meta object reports credits_used, credits_remaining, whether the result was cached, and a request_id you can quote to support. You send a POST to https://api.1lookup.dev/v1/ followed by the product slug.

Which countries do the products cover?

It depends on the product, and each product page lists its coverage. Phone Validation returns carrier and Do Not Call data for the US and Canada and format, country and line type for 200+ countries. Several registry products, such as DNC Scrub and NPI Lookup, are US only, and others, such as IP Intelligence and Email Validation, are global.

Do I need to write code to use it?

No. You can run single lookups and upload CSV files from the dashboard. The API is there when you want to call a product from your own application or pipeline.

Can I try it before paying?

Yes. Test keys, which start with 1lk_test_, return each product's sample response and never spend credits, so you can build and test an integration before you subscribe. The free tools on this site also run a few live lookups a day. Creating an account costs nothing.

Credits and pricing

What is a credit?

A credit is the unit you spend on lookups. One balance works across every product, and each product charges its own number of credits per lookup, search, check or report. You do not hold separate budgets for phone, email and company data.

How many credits does each product cost?

Prices are listed per product in the catalog and on each product page. For example, Phone Validation, Email Validation and IP Intelligence cost 1 credit, Email Authentication Check costs 2, Carrier Lookup costs 3, HLR Lookup costs 5, and DNC Scrub costs 10. A price marked from is a starting price for that product.

Is there a free plan or a free trial?

No. Every account is on a monthly plan, and plans start at $29 a month for 6,000 credits. Creating an account costs nothing, and test keys return sample responses without spending credits, so you can build before you subscribe.

What do the plans cost?

Starter is $29 a month with 6,000 credits, Growth is $99 with 25,000, Pro is $299 with 90,000 and Scale is $799 with 300,000. Paying yearly gives you two months free. Enterprise pricing starts at 1,000,000 credits a month and is quoted by sales. Every plan includes every product.

Do unused credits roll over?

Yes. Unused credits roll over for 3 months.

What happens when I use more than my plan includes?

Lookups keep working and the extra is pay as you go. Credits are added 1,000 at a time at your plan's pay-as-you-go rate: $5.00 per 1,000 on Starter, $4.50 on Growth, $4.00 on Pro and $3.50 on Scale. You set a monthly limit, so the extra can never go past it, and you can turn pay as you go off.

What happens when I run out of credits?

With pay as you go on, more credits are added and lookups continue. If you turned it off, or you reached your monthly limit, requests return an insufficient_credits error with HTTP status 402 and nothing is run or charged, until the plan renews or you upgrade.

Can I change or cancel my plan?

Yes. You can upgrade, downgrade or cancel at any time in the dashboard. A cancelled plan runs to the end of the period you have paid for.

Am I charged when I repeat a lookup?

Not within 7 days. Results are cached for 7 days, and repeating the same input in that window is free. Pass fresh set to true in the request when you want a new lookup instead of the cached result.

When am I not charged?

Requests that fail on our side are never charged. Products priced per match, shown as match in the catalog, charge only when a match is found. HLR Lookup also returns a not-applicable status at no charge when you send it a landline.

API and bulk

How do I authenticate?

Create an API key in the dashboard and send it as a bearer token in the Authorization header. Live keys start with 1lk_live_. Requests are JSON POSTs to https://api.1lookup.dev/v1/ followed by the product slug, for example phone-validation.

What is the rate limit?

The default is 50 requests per second per key. Higher limits are available on request. If you hit the limit, slow down and retry with a short backoff, or use a bulk job for large lists.

How do I process a large list?

Upload a CSV in the dashboard or use the bulk API. A bulk upload can have up to 1,000,000 rows. Results report row-level errors, so one bad row does not fail the file. A few products that make sense only one input at a time, such as Signup Check and Prospect Search, are not available in bulk.

How do webhooks work?

Bulk jobs fire a webhook when they finish, so you do not need to poll for status. Job Change Monitoring and Website Visitor ID also deliver their events by webhook.

What is an idempotency key and when do I need one?

Bulk jobs accept an idempotency key, a unique value you generate for each job. If your connection drops while you submit, send the same key again and you get the original job back instead of a duplicate and a second charge. Use a new key for each new job.

AI agents and MCP

What is the 1lookup.dev MCP server?

It is a Model Context Protocol server at https://mcp.1lookup.dev/mcp. Once you add it to an AI client, the model can call 1lookup.dev tools to validate a phone number, verify an email, look up an IP address, or run any other product by slug, then use the result in its answer.

Which clients can connect to it?

Claude, ChatGPT, Cursor and other MCP clients. Any client that supports remote MCP servers can use the URL. MCP access is included with every plan.

Which tools does it expose?

Eight tools. validate_phone, verify_email and lookup_ip cover the most common checks. run_lookup runs any product in the catalog by its slug, and search_products finds the right product and its credit cost for a task. bulk_submit and bulk_status start a bulk job and fetch its results, and get_account returns your credit balance, plan and recent usage.

How does the server know who I am?

The server is tied to your 1lookup.dev account, so tool calls are attributed to your credit balance. Add the URL in your client and complete the sign-in step it presents. Check the dashboard for the current setup instructions for your client.

How are credits spent when an agent calls a tool?

A tool call that runs a lookup spends the same credits as the equivalent API request, from the same balance. Cached results are free within 7 days, and failed requests are not charged. Ask the agent to call get_account to see your balance and recent usage, and use search_products to see a product's cost before running it.

Data and compliance

Where does the data come from?

Sources depend on the product. Registry products read public registries such as the FTC, FCC, FMCSA, CMS NPPES, SEC EDGAR, GLEIF, FDIC, EPA ECHO, CFPB, NHTSA, US Census, EU VIES and IRS data. Phone products use carrier and network sources, and other products use licensed data providers or public web pages. We do not name individual providers.

Are results always accurate?

No. Some results are estimates, such as IP geolocation, traffic figures and company size bands, and coverage differs by product and country. Treat each result as an input to your own decision, check the coverage on the product page, and re-check old records, since numbers, emails and jobs change.

What can I use the people-data products for?

Skip Trace, Reverse Phone Lookup, Reverse Email Lookup and Email Append are for business uses such as completing contact records, verifying a lead and reaching former customers. They must not be used for credit, employment, tenant or insurance decisions, and not for stalking, harassment or locating a private individual for personal reasons.

Which products need approval?

Website Visitor ID, Private Funding & Financials, PEP & Debarment Screening and Federal Litigation Check are marked approval in the catalog. Each needs a short use-case review before it is switched on for your account.

Does 1lookup.dev hold security or compliance certifications?

We do not claim any certifications or attestations. If your vendor review requires specific ones, contact 1lookup@volods.com before you decide.

Does a lookup make my calling or screening compliant?

No. A lookup gives you inputs to your own compliance process. Do Not Call status, line type and sanctions matches are data points, and decisions about consent, calling rules and screening remain yours. This is general information and is not legal advice, so talk to counsel about your program.

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