Introduction
One API for phone, email, IP, company and registry lookups. Connect an AI client in a minute, or call it from your own code.
1lookup.dev is a data lookup API. One key and one credit balance give you 79 products that validate and enrich contact, company and network data. Every product takes a small JSON body and returns the same JSON envelope, so what you learn on one endpoint applies to all of them.
Get started
Sign in through the browser.
Add 1lookup.dev as a custom connector in Claude and sign in through the browser.
https://mcp.1lookup.dev/mcp- Open the connector settings in Claude and choose to add a custom connector.
- Name it 1lookup and paste the connector URL.
- Approve the sign-in page that opens, then enable the connector in a new chat.
https://mcp.1lookup.dev/mcpBuild directly with the API
Every product is one POST endpoint. Send the identifier you have, read the result, and check the meta block for what the call cost.
Create an API key
Create an account, open API & MCP in the dashboard and create a key. Live keys start with
1lk_live_and spend credits from your plan. Plans start at $29 a month.Send a request
The base URL is
https://api.1lookup.dev. Each product lives at/v1/{product-slug}. Send your key as a Bearer token and the input as JSON.Requestcurl -X POST https://api.1lookup.dev/v1/phone-validation \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"phone_number":"+15125550142"}'Read the response
Every endpoint returns the same envelope.
dataholds the product result, andmetatells you what the call cost and what is left.200 OK{ "success": true, "data": { "phone_number": "+15125550142", "valid": true, "line_type": "mobile", "carrier": { "name": "Example Wireless", "ocn": "6010", "lrn": "+15125550000", "ported": true }, "location": { "city": "Austin", "state": "TX", "country": "US", "timezone": "America/Chicago" }, "dnc": { "listed": false, "dno": false }, "risk": { "level": "low", "factors": [] } }, "meta": { "credits_used": 1, "credits_remaining": 999, "cached": false, "request_id": "req_8f3a2c1e9b7d" } }successbooleantrue when the lookup ran. A false response carries an error object instead of data.
dataobjectThe product result. Its fields are documented on each endpoint page.
meta.credits_usedintegerCredits charged for this call. 0 for cached repeats, misses on match-priced products and failures.
meta.credits_remainingintegerYour balance after the call.
meta.cachedbooleantrue when the result came from the 7-day cache.
meta.request_idstringQuote this when you contact support.
Request options
These optional fields are accepted by every endpoint, alongside the product's own fields.
freshbooleanSkip the 7-day cache and run a new lookup. Charged as a normal lookup.
referencestringYour own identifier, echoed back in meta and shown in lookup history.
What you can look up
The 79 products are grouped by the kind of data they return. Each group links to its endpoints in the API reference.