[{"data":1,"prerenderedAt":536},["ShallowReactive",2],{"docs-\u002Fdocs":3,"docs-nav":510},{"id":4,"title":5,"body":6,"description":502,"extension":503,"meta":504,"navigation":505,"path":506,"seo":507,"stem":508,"__hash__":509},"docs\u002Fdocs\u002F1.index.md","Quick Start",{"type":7,"value":8,"toc":496},"minimark",[9,14,21,24,67,70,75,103,112,116,123,195,413,421,425,445,449,492],[10,11,13],"h1",{"id":12},"signupsieve-api-docs","SignupSieve API docs",[15,16,17],"p",{},[18,19,20],"strong",{},"Catch fake signups, not just bad emails.",[15,22,23],{},"SignupSieve tells you whether a real, unique person is behind an email address. One call returns:",[25,26,27,38,58],"ul",{},[28,29,30,31,37],"li",{},"a ",[18,32,33],{},[34,35,36],"code",{},"human_score"," from 0 to 100,",[28,39,30,40,45,46,49,50,53,54,57],{},[18,41,42],{},[34,43,44],{},"verdict",": ",[34,47,48],{},"allow",", ",[34,51,52],{},"review"," or ",[34,55,56],{},"block",",",[28,59,60,61,66],{},"the ",[18,62,63],{},[34,64,65],{},"reasons"," behind it.",[15,68,69],{},"It never contacts mail servers, answers in milliseconds, and learns from the outcomes you report.",[71,72,74],"h2",{"id":73},"get-an-api-key","Get an API key",[76,77,78,89,96],"ol",{},[28,79,80,81,88],{},"Open SignupSieve on ",[82,83,87],"a",{"href":84,"rel":85},"https:\u002F\u002Frapidapi.com\u002FKeirStephanCTombocon\u002Fapi\u002Fsignupsieve",[86],"nofollow","RapidAPI"," and sign in (free).",[28,90,91,92,95],{},"Subscribe to the ",[18,93,94],{},"Basic"," plan: 1,000 checks a month, no card needed.",[28,97,98,99,102],{},"Copy your key and host from the ",[18,100,101],{},"Code Snippets"," panel.",[104,105,106],"blockquote",{},[15,107,108,111],{},[18,109,110],{},"Keep your RapidAPI key on your server."," Never put it in browser or mobile app code.",[71,113,115],{"id":114},"quick-start-first-call-in-2-minutes","Quick start (first call in 2 minutes)",[15,117,118,119,122],{},"Send the address in a ",[34,120,121],{},"POST"," body. Add the user's IP if you have it; this is optional but catches more bots.",[124,125,130],"pre",{"className":126,"code":127,"language":128,"meta":129,"style":129},"language-bash shiki shiki-themes signupsieve","curl -X POST \"https:\u002F\u002Fsignupsieve.p.rapidapi.com\u002Fv1\u002Fcheck\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -H \"X-RapidAPI-Key: YOUR_RAPIDAPI_KEY\" \\\n  -H \"X-RapidAPI-Host: signupsieve.p.rapidapi.com\" \\\n  -d '{\"email\": \"maria.santos@gmail.com\", \"ip\": \"203.177.10.10\"}'\n","bash","",[34,131,132,155,166,176,186],{"__ignoreMap":129},[133,134,137,141,145,149,152],"span",{"class":135,"line":136},"line",1,[133,138,140],{"class":139},"sLaUg","curl",[133,142,144],{"class":143},"shnHK"," -X",[133,146,148],{"class":147},"sG-eq"," POST",[133,150,151],{"class":147}," \"https:\u002F\u002Fsignupsieve.p.rapidapi.com\u002Fv1\u002Fcheck\"",[133,153,154],{"class":143}," \\\n",[133,156,158,161,164],{"class":135,"line":157},2,[133,159,160],{"class":143},"  -H",[133,162,163],{"class":147}," \"Content-Type: application\u002Fjson\"",[133,165,154],{"class":143},[133,167,169,171,174],{"class":135,"line":168},3,[133,170,160],{"class":143},[133,172,173],{"class":147}," \"X-RapidAPI-Key: YOUR_RAPIDAPI_KEY\"",[133,175,154],{"class":143},[133,177,179,181,184],{"class":135,"line":178},4,[133,180,160],{"class":143},[133,182,183],{"class":147}," \"X-RapidAPI-Host: signupsieve.p.rapidapi.com\"",[133,185,154],{"class":143},[133,187,189,192],{"class":135,"line":188},5,[133,190,191],{"class":143},"  -d",[133,193,194],{"class":147}," '{\"email\": \"maria.santos@gmail.com\", \"ip\": \"203.177.10.10\"}'\n",[124,196,200],{"className":197,"code":198,"language":199,"meta":129,"style":129},"language-json shiki shiki-themes signupsieve","{\n  \"email\": \"maria.santos@gmail.com\",\n  \"canonical\": \"mariasantos@gmail.com\",\n  \"account_type\": \"free\",\n  \"role_account\": false,\n  \"disposable\": false,\n  \"relay\": false,\n  \"deliverable_domain\": true,\n  \"mail_provider\": \"google\",\n  \"human_score\": 94,\n  \"verdict\": \"allow\",\n  \"reasons\": [\"natural_name\", \"dotted_gmail\"],\n  \"ip\": { \"tor\": false, \"signups_from_ip\": 1 },\n  \"check_id\": \"chk_AXDmekmC35NL1mpGtCtC...\",\n  \"model\": \"baseline\"\n}\n","json",[34,201,202,208,222,234,246,258,270,282,295,308,321,334,354,383,396,407],{"__ignoreMap":129},[133,203,204],{"class":135,"line":136},[133,205,207],{"class":206},"sp0VP","{\n",[133,209,210,214,216,219],{"class":135,"line":157},[133,211,213],{"class":212},"sZvsG","  \"email\"",[133,215,45],{"class":206},[133,217,218],{"class":147},"\"maria.santos@gmail.com\"",[133,220,221],{"class":206},",\n",[133,223,224,227,229,232],{"class":135,"line":168},[133,225,226],{"class":212},"  \"canonical\"",[133,228,45],{"class":206},[133,230,231],{"class":147},"\"mariasantos@gmail.com\"",[133,233,221],{"class":206},[133,235,236,239,241,244],{"class":135,"line":178},[133,237,238],{"class":212},"  \"account_type\"",[133,240,45],{"class":206},[133,242,243],{"class":147},"\"free\"",[133,245,221],{"class":206},[133,247,248,251,253,256],{"class":135,"line":188},[133,249,250],{"class":212},"  \"role_account\"",[133,252,45],{"class":206},[133,254,255],{"class":143},"false",[133,257,221],{"class":206},[133,259,261,264,266,268],{"class":135,"line":260},6,[133,262,263],{"class":212},"  \"disposable\"",[133,265,45],{"class":206},[133,267,255],{"class":143},[133,269,221],{"class":206},[133,271,273,276,278,280],{"class":135,"line":272},7,[133,274,275],{"class":212},"  \"relay\"",[133,277,45],{"class":206},[133,279,255],{"class":143},[133,281,221],{"class":206},[133,283,285,288,290,293],{"class":135,"line":284},8,[133,286,287],{"class":212},"  \"deliverable_domain\"",[133,289,45],{"class":206},[133,291,292],{"class":143},"true",[133,294,221],{"class":206},[133,296,298,301,303,306],{"class":135,"line":297},9,[133,299,300],{"class":212},"  \"mail_provider\"",[133,302,45],{"class":206},[133,304,305],{"class":147},"\"google\"",[133,307,221],{"class":206},[133,309,311,314,316,319],{"class":135,"line":310},10,[133,312,313],{"class":212},"  \"human_score\"",[133,315,45],{"class":206},[133,317,318],{"class":143},"94",[133,320,221],{"class":206},[133,322,324,327,329,332],{"class":135,"line":323},11,[133,325,326],{"class":212},"  \"verdict\"",[133,328,45],{"class":206},[133,330,331],{"class":147},"\"allow\"",[133,333,221],{"class":206},[133,335,337,340,343,346,348,351],{"class":135,"line":336},12,[133,338,339],{"class":212},"  \"reasons\"",[133,341,342],{"class":206},": [",[133,344,345],{"class":147},"\"natural_name\"",[133,347,49],{"class":206},[133,349,350],{"class":147},"\"dotted_gmail\"",[133,352,353],{"class":206},"],\n",[133,355,357,360,363,366,368,370,372,375,377,380],{"class":135,"line":356},13,[133,358,359],{"class":212},"  \"ip\"",[133,361,362],{"class":206},": { ",[133,364,365],{"class":212},"\"tor\"",[133,367,45],{"class":206},[133,369,255],{"class":143},[133,371,49],{"class":206},[133,373,374],{"class":212},"\"signups_from_ip\"",[133,376,45],{"class":206},[133,378,379],{"class":143},"1",[133,381,382],{"class":206}," },\n",[133,384,386,389,391,394],{"class":135,"line":385},14,[133,387,388],{"class":212},"  \"check_id\"",[133,390,45],{"class":206},[133,392,393],{"class":147},"\"chk_AXDmekmC35NL1mpGtCtC...\"",[133,395,221],{"class":206},[133,397,399,402,404],{"class":135,"line":398},15,[133,400,401],{"class":212},"  \"model\"",[133,403,45],{"class":206},[133,405,406],{"class":147},"\"baseline\"\n",[133,408,410],{"class":135,"line":409},16,[133,411,412],{"class":206},"}\n",[104,414,415],{},[15,416,417,418,420],{},"Use the exact host and key shown in the ",[18,419,101],{}," panel on our RapidAPI listing. The host above is an example.",[71,422,424],{"id":423},"privacy","Privacy",[25,426,427,433,436,439,442],{},[28,428,429,430],{},"Email and IP addresses are analyzed, then forgotten. ",[18,431,432],{},"Never stored, never sold.",[28,434,435],{},"We never send email or contact mail servers, so checks are silent and your IP is never blacklisted.",[28,437,438],{},"We store only domain-level data (mail servers, outcome counts) and one-way hashes that cannot be turned back into addresses.",[28,440,441],{},"For labelled checks, we store the signal numbers and the outcome, not the address.",[28,443,444],{},"To allow feedback by email, we keep your latest check of each inbox for 14 days, under a one-way hash of the address.",[71,446,448],{"id":447},"next-steps","Next steps",[25,450,451,458,465,472,479],{},[28,452,453,457],{},[82,454,456],{"href":455},"\u002Fdocs\u002Fverdicts","Use the verdict",": what to do with allow, review and block.",[28,459,460,464],{},[82,461,463],{"href":462},"\u002Fdocs\u002Fendpoints","Endpoints",": single, bulk, feedback and model stats.",[28,466,467,471],{},[82,468,470],{"href":469},"\u002Fdocs\u002Fexamples","Code examples",": Node.js, Python, PHP, Next.js, Express and Laravel.",[28,473,474,478],{},[82,475,477],{"href":476},"\u002Fpricing","Pricing",": from $0 a month.",[28,480,481,482,486,487,491],{},"Download the ",[82,483,485],{"href":484},"\u002Fopenapi.yaml","OpenAPI spec"," or the ",[82,488,490],{"href":489},"\u002Fsignupsieve-postman-collection.json","Postman collection",".",[493,494,495],"style",{},"html pre.shiki code .sLaUg, html code.shiki .sLaUg{--shiki-default:#FFFFFF}html pre.shiki code .shnHK, html code.shiki .shnHK{--shiki-default:#FDE68A}html pre.shiki code .sG-eq, html code.shiki .sG-eq{--shiki-default:#2EE59D}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html pre.shiki code .sp0VP, html code.shiki .sp0VP{--shiki-default:#E2E8F0}html pre.shiki code .sZvsG, html code.shiki .sZvsG{--shiki-default:#BAE6FD}",{"title":129,"searchDepth":157,"depth":157,"links":497},[498,499,500,501],{"id":73,"depth":157,"text":74},{"id":114,"depth":157,"text":115},{"id":423,"depth":157,"text":424},{"id":447,"depth":157,"text":448},"Make your first SignupSieve API call in 2 minutes: get a free key, check an email address and read the verdict.","md",{},true,"\u002Fdocs",{"title":5,"description":502},"docs\u002F1.index","bDL_q_hU5hcLv9PQJbSwgPsODvTpO3b9iT_7uyZmpGA",[511,512,515,517,521,525,529,533],{"path":506,"title":5,"stem":508},{"path":455,"title":513,"stem":514},"Verdicts","docs\u002F2.verdicts",{"path":462,"title":463,"stem":516},"docs\u002F3.endpoints",{"path":518,"title":519,"stem":520},"\u002Fdocs\u002Fresponse-fields","Response Fields","docs\u002F4.response-fields",{"path":522,"title":523,"stem":524},"\u002Fdocs\u002Freason-codes","Reason Codes","docs\u002F5.reason-codes",{"path":526,"title":527,"stem":528},"\u002Fdocs\u002Ffeedback","Feedback","docs\u002F6.feedback",{"path":530,"title":531,"stem":532},"\u002Fdocs\u002Ferrors","Errors and Billing","docs\u002F7.errors",{"path":469,"title":534,"stem":535},"Code Examples","docs\u002F8.examples",1792516807768]