Signup check API: allow, review or block in one call
Call it when someone registers. It validates the email, inspects the IP, checks disposable-domain lists and, if you send a phone number, its line type. You get one verdict with reason codes for 5 credits.
{
"success": true,
"data": {
"verdict": "review",
"reason_codes": [
"ip_vpn",
"ip_hosting"
],
"email": {
"address": "jane.doe@example.com",
"valid": true,
"mailbox": "deliverable",
"disposable": false,
"role_account": false
},
"ip": {
"address": "203.0.113.42",
"country": "US",
"vpn": true,
"proxy": false,
"tor": false,
"hosting": true,
"blocklisted": false
},
"phone": {
"phone_number": "+15125550142",
"valid": true,
"line_type": "mobile"
},
"checked_at": "2026-11-19T14:03:22Z"
},
"meta": {
"credits_used": 5,
"credits_remaining": 999,
"cached": false,
"request_id": "req_8f3a2c1e9b7d"
}
}What you get back
The fields most teams branch on. The full response is in the sample on this page and in the API reference.
verdictVerdictallow, review or block. The one field your registration handler needs to branch on.reason_codesReason codesShort machine-readable codes for each finding behind the verdict, such as ip_vpn or email_disposable.email.validEmail validityWhether the address passed syntax, domain and mailbox checks.email.disposableDisposable emailTrue when the email domain appears on disposable-domain lists.ip.vpnAnonymizer flagsVPN flag for the signup IP, with proxy, Tor and hosting reported next to it.ip.countryIP countryThe country the signup request came from.phone.line_typePhone line typeReturned when you include a phone number: mobile, landline or voip.What Signup Check does
One request at the registration step
Your signup handler makes a single call with the email and IP it already has. There is no need to chain an email API, an IP API and a blocklist, then reconcile three responses.
A verdict you can branch on
The response opens with allow, review or block. Create the account, hold it for verification or reject it, with one switch statement.
Reason codes behind every verdict
Each verdict arrives with the codes that produced it. Store them with the account so support can answer a blocked user, and so you can see which checks are doing the work.
Optional phone type check
Include a phone number and the check adds its validity and line type. Leave it out and the verdict rests on email and IP alone, at the same price.
See the response before you sign up
Fill in the request and run it. The dashboard has the same form, plus history, bulk upload and live data.
Fill in the field and run the lookup to see what comes back.
One POST request
Send JSON with a Bearer key. The same key works for all 79 products.
curl -X POST https://api.1lookup.dev/v1/signup-check \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"email":"jane.doe@example.com","ip":"203.0.113.42"}'- Endpoint
POST /v1/signup-check- Base URL
https://api.1lookup.dev- Request
emailipphone_number?- Price
- 5 credits / check
- Coverage
- Global
- Bulk
- Single requests
- Cache
- Repeats within 7 days are free
- Also via
- Dashboard and MCP server (run_lookup)
What teams use it for
Stop disposable-email signups on a free tier
Block addresses from throwaway domains before they consume trial resources or free credits.
Step up verification only when needed
Send review verdicts to an email confirmation or SMS code and let allow verdicts skip the extra step, so most real users never see added friction.
Protect referral and promo programs
Check each new account before a bonus is paid. A signup from a Tor or hosting IP with a throwaway email rarely belongs to a new customer.
Keep bad addresses out of your user table
Reject emails that fail validation at the form, so welcome messages do not bounce and drag down your sender reputation.
Privacy-conscious users and corporate networks often sit behind VPNs. Treat review as a prompt for extra verification, not as a rejection.
5 credits / check
Credits come with your plan and work on every product. Requests that fail on our side are never charged. Beyond your plan, extra credits are pay as you go.
See pricing| Plan | Per 1,000 credits | Per 1,000 checks |
|---|---|---|
| Starter $29/mo | $4.83 | $24.17 |
| Growth $99/mo | $3.96 | $19.80 |
| Pro $299/mo | $3.32 | $16.61 |
| Scale $799/mo | $2.66 | $13.32 |
Signup Check questions
What does Signup Check look at?
The email (syntax, domain, mailbox and disposable-domain lists), the IP address (location, VPN, proxy, Tor, hosting and blocklists) and, when you send it, the phone number's validity and line type. The findings are combined into a single verdict.
What do allow, review and block mean?
allow means nothing concerning was found. review means some signals call for a second look. block means the findings are strong enough that we would not create the account. The reason codes say exactly what was found, and what your product does with each verdict is up to you.
How much is a signup check?
5 credits per check, with or without the optional phone number. That is one charge for work that would otherwise take separate email, IP and phone lookups.
How is Signup Check different from Fraud Detection?
Signup Check is built for the registration moment: it requires an email and an IP and answers with a verdict. Fraud Detection accepts any mix of email, phone and IP, returns a 0 to 100 score with the rules that fired, and suits orders, leads and batch review.
Can I run Signup Check on a CSV?
No. It is a single-call API meant to run inline at registration, and it has no bulk upload. To score an existing list, use Fraud Detection, which supports CSV upload and the bulk API.
Related products
Fraud Detection
One rule-based fraud score from any mix of email, phone and IP signals.
Email Validation
Syntax, domain, mailbox and catch-all checks with disposable and role detection.
Phone Validation
Validity, carrier, line type, porting, DNC status and a risk level for any number.
Run Signup Check on your own data
Starter is $29 a month for 6,000 credits, enough for 1,200 checks a month.