{"components":{"schemas":{"BulkRequest":{"properties":{"emails":{"items":{"format":"email","type":"string"},"maxItems":50,"type":"array"},"scoring":{"default":false,"type":"boolean"},"webhook_url":{"description":"HTTPS callback URL (optional)","format":"uri","type":"string"}},"required":["emails"],"type":"object"},"BulkResponse":{"properties":{"count":{"type":"integer"},"remaining":{"type":"integer"},"results":{"items":{"$ref":"#/components/schemas/VerifyResult"},"type":"array"},"summary":{"type":"object"},"webhook":{"enum":["queued"],"type":"string"}},"type":"object"},"VerifyResult":{"properties":{"cached":{"type":"boolean"},"confidence":{"enum":["high","medium","low","n/a"],"type":"string"},"duration_ms":{"type":"integer"},"email":{"example":"user@company.com","type":"string"},"is_free_provider":{"type":"boolean"},"is_gibberish":{"type":"boolean"},"is_role_account":{"type":"boolean"},"is_spam_trap":{"type":"boolean"},"mx_server":{"type":"string"},"reason":{"type":"string"},"remaining":{"type":"integer"},"scoring":{"description":"Present when scoring=true","type":"object"},"smtp_response":{"type":"string"},"source_ip":{"type":"string"},"status":{"enum":["valid","invalid","risky","catch_all","disposable","spam_trap","unknown","error","rate_limited","out_of_credits"],"type":"string"}},"type":"object"}},"securitySchemes":{"ApiKeyAuth":{"description":"API key from dashboard (ev_\u2026)","in":"header","name":"X-API-Key","type":"apiKey"}}},"info":{"contact":{"url":"https://email-validaton.com/contact"},"description":"REST API for real-time SMTP email verification, bulk checks, email finder,\nand blacklist monitoring.\n\n**Authentication:** `X-API-Key` header (from your dashboard).\n\n**Credits:** Only `valid` and `invalid` results consume credits.\n`risky`, `catch_all`, `disposable`, `unknown`, and `spam_trap` are free.\n","title":"Email Validator API","version":"1.1.0"},"openapi":"3.0.3","paths":{"/account":{"get":{"responses":{"200":{"description":"Account details"}},"summary":"Account info (plan, credits)"}},"/blacklist/check":{"get":{"parameters":[{"in":"query","name":"target","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Blacklist scan results"}},"summary":"DNSBL check for domain or IP"}},"/bulk":{"post":{"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkResponse"}}},"description":"Bulk results"},"400":{"description":"Invalid request"}},"summary":"Bulk verify (up to 50 emails)"}},"/credits":{"get":{"responses":{"200":{"description":"Credits remaining"}},"summary":"Quick credit balance"}},"/domain-pattern":{"get":{"description":"Returns cached pattern from Email Finder (e.g. `{first}.{last}`).\nFree \u2014 no credits consumed.\n","parameters":[{"in":"query","name":"domain","required":true,"schema":{"example":"acme.com","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"domain":{"type":"string"},"example":{"example":"john.smith@acme.com","type":"string"},"found":{"type":"boolean"},"is_catch_all":{"type":"boolean"},"last_seen":{"type":"string"},"pattern":{"example":"{first}.{last}","type":"string"}},"type":"object"}}},"description":"Pattern lookup result"}},"summary":"Known email format pattern for a domain"}},"/finder":{"post":{"description":"1 free search/month, then 5 credits per search (flat, whether found or not).\n","requestBody":{"content":{"application/json":{"schema":{"properties":{"domain":{"type":"string"},"first_name":{"type":"string"},"last_name":{"type":"string"}},"required":["first_name","last_name","domain"],"type":"object"}}}},"responses":{"200":{"description":"Finder result"}},"summary":"Email finder (name + domain)"}},"/verify":{"get":{"parameters":[{"in":"query","name":"email","required":true,"schema":{"type":"string"}},{"in":"query","name":"scoring","schema":{"type":"boolean"}},{"in":"query","name":"webhook_url","schema":{"format":"uri","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyResult"}}},"description":"Verification result"}},"summary":"Verify single email (GET)"},"post":{"requestBody":{"content":{"application/json":{"schema":{"properties":{"email":{"type":"string"},"scoring":{"type":"boolean"},"webhook_url":{"format":"uri","type":"string"}},"required":["email"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyResult"}}},"description":"Verification result"}},"summary":"Verify single email (POST)"}}},"security":[{"ApiKeyAuth":[]}],"servers":[{"description":"Production","url":"https://email-validaton.com/api/v1"}]}