{"openapi":"3.1.0","info":{"title":"Email Validation API","description":"Validate email addresses — syntax, MX records, disposable detection, role-based detection, and SMTP verification.","version":"1.0.0"},"paths":{"/v1/validate":{"get":{"tags":["Validation"],"summary":"Validate a single email address","description":"Performs syntax check, MX record lookup, disposable detection, free provider detection, and role-based detection.","operationId":"validate_email_endpoint_v1_validate_get","parameters":[{"name":"email","in":"query","required":true,"schema":{"type":"string","description":"Email address to validate","title":"Email"},"description":"Email address to validate","example":"user@gmail.com"},{"name":"smtp_check","in":"query","required":false,"schema":{"type":"boolean","description":"Perform SMTP verification (slower)","default":false,"title":"Smtp Check"},"description":"Perform SMTP verification (slower)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/validate/batch":{"get":{"tags":["Validation"],"summary":"Validate multiple emails","operationId":"validate_batch_v1_validate_batch_get","parameters":[{"name":"emails","in":"query","required":true,"schema":{"type":"string","description":"Comma-separated email addresses","title":"Emails"},"description":"Comma-separated email addresses"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"EmailResponse":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"data":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Data"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","title":"EmailResponse"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"servers":[{"url":"/email"}]}