---
title: "Switch from 1lookup to LookValid: what moves"
url: "https://lookvalid.com/switch-from/1lookup.md"
canonical_url: "https://lookvalid.com/switch-from/1lookup"
last_updated: "2026-10-26"
type: "how-to"
summary: "What moves from 1lookup to LookValid, what you edit, and what changes in plans and limits: 11 steps, 10 matching lookups, every 1lookup fact sourced."
related: ["https://lookvalid.com/pricing.md", "https://lookvalid.com/docs/quickstart.md", "https://lookvalid.com/docs/credits-and-billing.md", "https://lookvalid.com/docs/errors.md", "https://lookvalid.com/docs/mcp.md", "https://lookvalid.com/integrations.md"]
---

# Switch from 1lookup to LookValid: what moves

> **For AI agents:** the complete index of LookValid pages is [llms.txt](https://lookvalid.com/llms.txt). Every page is also served as markdown at its URL plus .md.

What moves from 1lookup to LookValid, what you edit, and what changes in plans and limits: 11 steps, 10 matching lookups, every 1lookup fact sourced.

If you call 1lookup's API today, the move is 11 steps: 5 in the LookValid dashboard and 6 in your own code. Both products bill in credits from one balance, so the shape of your integration stays the same while the address, the key, the paths and the response fields change. This page lists what carries over, which of your lookups have a counterpart, and what is different.

## What moves over

| Item | On 1lookup | On LookValid and what you do |
| --- | --- | --- |
| API key and sign-in | Calls carry a secret key as a Bearer token in the Authorization header. Keys belong to an organization, and several can be held at once, so a rotation is create, deploy, delete. API access needs a paid plan. ([source](https://www.1lookup.io/docs)) | Same header scheme, new key. A LookValid key is created on the Keys tab, and keys do not transfer between providers. If a client cannot set an Authorization header it can send X-API-Key instead. |
| Address and request format | Each lookup is a POST with a JSON body to a path under https://app.1lookup.io/api/v1, such as /phone or /email. ([source](https://www.1lookup.io/docs)) | Each lookup is a POST with a JSON body to https://YOUR_API_HOST/v1/<product>. The product names differ, so each path is remapped using the overlap table. |
| Response shape | A success returns success: true and a data object; the credits a call spent are under data.metadata. ([source](https://www.1lookup.io/docs)) | A lookup that ran returns HTTP 200 with found, data, reason, sources, credits_charged, credits_remaining and cache_hit at the top level. Update the parser once. |
| Repeat lookups | Repeat lookups are served from a 7-day cache and cost 0 credits, and a bypass_cache flag forces a fresh lookup. ([source](https://www.1lookup.io/docs)) | Repeats by the same account inside 7 days are free and return cache_hit: true. There is no flag to skip the cache, so an input you need fresh is run after the window. |
| Rate limits and back-off | Standard lookups are limited to 200 requests per 10 seconds on each key. A limited request returns 429 with Retry-After and X-RateLimit headers. ([source](https://www.1lookup.io/docs)) | 200 requests per 10 seconds on each key, on every plan. A 429 carries Retry-After, so the back-off you wrote keeps working. |
| Lists and batch work | A bulk job takes up to 100,000 rows in one API call and reports back by polling or a webhook. ([source](https://www.1lookup.io/docs)) | LookValid runs lists from the Jobs tab: upload a CSV of up to 10,000 rows, choose the product, and download the results. List jobs are started in the dashboard, so a script that submitted jobs over the API is replaced by an upload. |
| AI clients over MCP | A hosted MCP server at https://app.1lookup.io/api/mcp takes the key as a Bearer token, or a sign-in with OAuth. ([source](https://www.1lookup.io/docs)) | Connect to https://YOUR_API_HOST/v1/mcp with the same style of key, or sign in with OAuth. Tools: phone, country_code, email_domain_check, ip, phone_spam, link_safety, carrier_lookup, vin_decoder, link_in_bio_lookup, domain_authority, domain_age, website_contacts_scraper, site_files, website_scraper, get_account. The free tools work with no key. |
| No-code automations | Zapier, Make and n8n integrations are listed in its integration library. ([source](https://www.1lookup.io/docs)) | Rebuild each workflow in the same tool as a request step that calls LookValid with a Bearer key. The integrations pages have a recipe for Zapier, Make and n8n. |
| Balances and history | Unused subscription credits roll over for up to 3 months. ([source](https://www.1lookup.io/pricing)) | Credits come from a LookValid plan and unused monthly credits stay spendable for 3 months. LookValid has no import for another provider's balance or history, so download any results you still need before you end the old plan. |

### Lookups that overlap

| Lookup | On 1lookup | On LookValid |
| --- | --- | --- |
| Phone number check | POST /api/v1/phone, 1 credit per lookup ([source](https://www.1lookup.io/docs)) | [Phone Numbering-Plan Validation](https://lookvalid.com/products/phone.md): POST /v1/phone, 1 credit per valid number, charged only when the lookup finds something. LookValid checks a number against its numbering plan: format, country, number type and area. It does not test whether the line is reachable. |
| Email address check | POST /api/v1/email, 1 credit per lookup ([source](https://www.1lookup.io/docs)) | [Email Domain Check](https://lookvalid.com/products/email-domain-check.md): POST /v1/email-domain-check, 1 credit per address checked, charged only when the lookup finds something. LookValid checks the domain behind an address: mail servers, DNS setup and provider type. It does not test whether one mailbox exists. |
| IP address lookup | POST /api/v1/ip, 1 credit per lookup ([source](https://www.1lookup.io/docs)) | [IP Intelligence](https://lookvalid.com/products/ip.md): POST /v1/ip, 1 credit per lookup, charged only when the lookup finds something. |
| Phone spam check | POST /api/v1/phone-spam, 1 credit per lookup ([source](https://www.1lookup.io/docs)) | [Phone Spam Check](https://lookvalid.com/products/phone-spam.md): POST /v1/phone-spam, 1 credit per number with complaints on record, charged only when the lookup finds something. |
| Domain age | POST /api/v1/domain-age, 2 credits per lookup ([source](https://www.1lookup.io/docs)) | [Domain Age](https://lookvalid.com/products/domain-age.md): POST /v1/domain-age, 2 credits per registered domain (unregistered domains are free), charged only when the lookup finds something. |
| Domain authority | POST /api/v1/domain-authority, 10 credits per lookup ([source](https://www.1lookup.io/docs)) | [Domain Authority](https://lookvalid.com/products/domain-authority.md): POST /v1/domain-authority, 10 credits per domain found in the rank data (an unranked domain is free), charged only when the lookup finds something. |
| VIN decoder | POST /api/v1/vin-decoder, 2 credits per lookup ([source](https://www.1lookup.io/docs)) | [VIN Decoder](https://lookvalid.com/products/vin-decoder.md): POST /v1/vin-decoder, 1 credit per VIN that decodes (a VIN with no data is free), charged only when the lookup finds something. |
| Link-in-bio page reader | POST /api/v1/link-in-bio-lookup, 3 credits per lookup ([source](https://www.1lookup.io/docs)) | [Link-in-Bio Lookup](https://lookvalid.com/products/link-in-bio-lookup.md): POST /v1/link-in-bio-lookup, 3 credits per resolved page (dead or empty pages are free), charged only when the lookup finds something. |
| Web page reader | POST /api/v1/website-scraper, 10 credits per lookup ([source](https://www.1lookup.io/docs)) | [Website Scraper](https://lookvalid.com/products/website-scraper.md): POST /v1/website-scraper, 10 credits per successful scrape (errors, empty and blocked pages are free), charged only when the lookup finds something. |
| Website contact finder | POST /api/v1/website-contacts-scraper, 10 credits per lookup ([source](https://www.1lookup.io/docs)) | [Website Contacts Scraper](https://lookvalid.com/products/website-contacts-scraper.md): POST /v1/website-contacts-scraper, 10 credits per domain with contacts found, charged only when the lookup finds something. |

### Error codes

| 1lookup | LookValid |
| --- | --- |
| UNAUTHORIZED, HTTP 401 ([source](https://www.1lookup.io/docs)) | `unauthorized`, HTTP 401 |
| INSUFFICIENT_CREDITS, HTTP 402 ([source](https://www.1lookup.io/docs)) | `insufficient_credits`, HTTP 402 |
| NOT_FOUND, HTTP 404 ([source](https://www.1lookup.io/docs)) | `not_found`, HTTP 404 |
| INVALID_INPUT, HTTP 400 ([source](https://www.1lookup.io/docs)) | `invalid_input`, HTTP 400 |
| RATE_LIMIT_EXCEEDED, HTTP 429 ([source](https://www.1lookup.io/docs)) | `rate_limited`, HTTP 429 |
| INTERNAL_ERROR, HTTP 500 ([source](https://www.1lookup.io/docs)) | `internal_error`, HTTP 500 |
| SERVICE_UNAVAILABLE, HTTP 503 ([source](https://www.1lookup.io/docs)) | `provider_unavailable`, HTTP 503 |

## How much work it is

11 steps: 5 in the LookValid dashboard and 6 in your own code.

1. **Start a LookValid plan** (dashboard). Starter, Growth and Professional each start with a 7-day trial for $1 that allows 100 credits. The trial runs next to your current provider, so nothing has to stop first.
2. **Create an API key** (dashboard). Open the Keys tab and create one key per application or environment. A key is shown once, so store it before you close the dialog.
3. **Run one lookup by hand** (dashboard). Use the quick lookup on the dashboard overview with a value you already know the answer to, so you see the real response before you write any code.
4. **Point your client at the new address and key** (your code). Requests go to https://YOUR_API_HOST/v1/<product>. The Authorization header with a Bearer key is the same scheme you already send; only the key and the address change. Read the key from LOOKVALID_API_KEY.
5. **Map each endpoint you call** (your code). Use the overlap table above to swap each path. Anything that has no LookValid counterpart stays with its current provider.
6. **Update how you read a response** (your code). Branch on found instead of success, read the result from data, and read the cost from credits_charged and credits_remaining.
7. **Update how you handle errors** (your code). Error codes are lower case and each carries a retryable flag. Use the error table above to rename the codes your handler branches on.
8. **Keep your retry logic** (your code). A 429 carries Retry-After and the X-RateLimit headers on LookValid too, so a back-off that reads Retry-After carries over. The limit is 200 requests per 10 seconds on each key.
9. **Move list jobs to the Jobs tab** (dashboard). Upload a CSV, pick the column and the product, and download the results when the job finishes. A file holds up to 10,000 rows.
10. **Reconnect AI clients and automations** (your code). Point each MCP client at https://YOUR_API_HOST/v1/mcp and send the same style of Bearer key. Rebuild each Zapier, Make or n8n workflow as a request step that calls LookValid with a Bearer key; the integrations pages have a recipe for each tool.
11. **Compare balances, then end the old plan** (dashboard). Check the first runs against the credits LookValid reports for them. When you are satisfied, cancel the old plan at the end of the period you already paid for.

## What changes

### Plans and prices

| Plan | 1lookup | LookValid |
| --- | --- | --- |
| Starter | $99 a month for 20,000 credits, $0.0050 per credit ([source](https://www.1lookup.io/pricing)) | $99 a month for 20,000 credits, $0.0050 per credit |
| Growth | $299 a month for 85,000 credits, $0.0035 per credit ([source](https://www.1lookup.io/pricing)) | $299 a month for 85,000 credits, $0.0035 per credit |
| Professional | $799 a month for 250,000 credits, $0.0032 per credit ([source](https://www.1lookup.io/pricing)) | $799 a month for 250,000 credits, $0.0032 per credit |
| Enterprise | $1,999 a month for 1,000,000 credits, $0.0020 per credit ([source](https://www.1lookup.io/pricing)) | $1,999 a month for 1,000,000 credits, $0.0020 per credit, set up on a call |

### Differences

| Topic | 1lookup | LookValid |
| --- | --- | --- |
| Free plan | A free plan gives 25 credits a month for dashboard use. ([source](https://help.1lookup.io/en/article/cancelling-billing-and-refunds-15gunq3/)) | LookValid sells paid plans only (Starter, Growth, Professional online, Enterprise on a call). The free tools on the website run a set of the same lookups with no account. |
| Trial | Every plan starts with a 7-day free trial with $5 of credits on Starter and $20 on the larger plans, and nothing is charged at signup. ([source](https://www.1lookup.io/pricing)) | Starter, Growth and Professional start with a 7-day trial for $1 at signup that allows 100 credits. If the allowance runs out first, lookups pause until you start the plan yourself. When the 7 days end, the plan starts and your card is charged for the first month unless you cancel. |
| Largest plan and custom volume | Enterprise has a free trial like the other plans, and a custom plan for more than 1,000,000 credits starts at $2,000 a month through its sales team. ([source](https://www.1lookup.io/pricing)) | Enterprise starts at $1,999 a month for 1,000,000 credits and is set up on a call; larger volumes are quoted there. |
| Cancelling | Cancelling is self-serve in the dashboard. A paid plan keeps its access until the end of the period already paid for. ([source](https://help.1lookup.io/en/article/cancelling-billing-and-refunds-15gunq3/)) | To cancel a LookValid plan, write to hello@lookvalid.com from your account email. Keep the old plan running until its period ends while you test, so both providers answer in the meantime. |
| Refunds | Refund requests are handled by a person, who follows up by email. ([source](https://help.1lookup.io/en/article/cancelling-billing-and-refunds-15gunq3/)) | A first paid month can be refunded when you ask within 7 days of the payment. A person reviews each request; write to hello@lookvalid.com. |
| Products you use | The API reference lists 78 live endpoints across phone, email, IP, web, company, social and business data. ([source](https://www.1lookup.io/docs)) | LookValid has 14 live lookups, 10 of them listed in the overlap table. A product with no LookValid counterpart stays with its current provider; you can run both on one codebase. |

## Questions

### Do I have to change code to move from 1lookup?

Yes. The address, the key, the product paths, the response fields and the error codes differ, so the calls you make and the code that reads their answers are edited. 6 of the 11 steps are code or configuration changes, and 5 happen in the dashboard.

### Can I keep my 1lookup plan while I test LookValid?

Yes. 1lookup's billing help says a paid plan stays accessible until the end of the period you already paid for after you cancel, so you can cancel first and keep testing, or run both until the period ends. A LookValid trial starts without ending anything else.

### Which lookups can I move?

10 lookups have a LookValid counterpart, listed in the overlap table with their paths and credit costs on both sides. Two of them, the phone number check and the email address check, answer a narrower question on LookValid, and the table says how.

### How are repeat lookups billed?

Both products serve a repeat lookup from a cache for 0 credits: 7 days on LookValid, 7 days on 1lookup per its API documentation. LookValid has no switch to skip the cache, and the cache belongs to your account.

### Do I get a LookValid balance to match what is left on my old plan?

No. LookValid credits come from a LookValid plan, and the trial allows 100 credits. Plan credits stay spendable for 3 months after they arrive.

## Sources

- [1lookup pricing page](https://www.1lookup.io/pricing), read 2026-10-26
- [1lookup API documentation](https://www.1lookup.io/docs), read 2026-10-26
- [1lookup help: cancelling, billing and refunds](https://help.1lookup.io/en/article/cancelling-billing-and-refunds-15gunq3/), read 2026-10-26

Spot something wrong or out of date? Write to hello@meralume.com and we will review it.

## Related

- [Plans, trial and credit pricing](https://lookvalid.com/pricing.md)
- [Quickstart](https://lookvalid.com/docs/quickstart.md)
- [Credits and billing](https://lookvalid.com/docs/credits-and-billing.md)
- [Errors](https://lookvalid.com/docs/errors.md)
- [MCP server](https://lookvalid.com/docs/mcp.md)
- [Tool integrations for phone, email and IP checks](https://lookvalid.com/integrations.md)
