Skip to content

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.

5 credits / checkValidateMCPNew
POST/v1/signup-check
{
  "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"
  }
}
[01/Response]

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.
[02/Capabilities]

What Signup Check does

01

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.

02

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.

03

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.

04

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.

[03/Try it]

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.

POST /v1/signup-check5 credits / check

IPv4 or IPv6

Preview mode: this page returns a sample response so you can see the shape of the data. Create a key to run it on live data.

Response

Fill in the field and run the lookup to see what comes back.

[04/Integrate]

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)
[05/Use cases]

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.

[06/Cost]

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
PlanPer 1,000 creditsPer 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
[07/FAQ]

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.

[ Validate ][ Enrich ]
[Get started]

Run Signup Check on your own data

Starter is $29 a month for 6,000 credits, enough for 1,200 checks a month.

[ Screen ][ Scrape ]