{"openapi":"3.0.3","info":{"title":"email-validate","description":"Email validation API: syntax, MX, disposable-domain, free-provider, role and typo checks","version":"0.1.0","contact":{"name":"support","url":"https://validmail.dev"}},"components":{"securitySchemes":{"apiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"Optional in this stage. Anonymous requests are rate-limited per IP; a valid key attributes usage to the key name (invalid keys get 401)."}},"schemas":{}},"paths":{"/v1/validate":{"get":{"operationId":"validateEmail","tags":["validation"],"parameters":[{"schema":{"type":"string","maxLength":320},"in":"query","name":"email","required":true},{"schema":{"type":"boolean","default":false},"in":"query","name":"allow_disposable","required":false}],"security":[{"apiKeyAuth":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string"},"verdict":{"type":"string","enum":["valid","risky","invalid"]},"score":{"type":"integer","minimum":0,"maximum":100},"suggestion":{"type":"string","description":"Null when the page does not provide it."},"domain":{"type":"string","description":"Null when the page does not provide it."},"checks":{"type":"object","properties":{"syntax":{"type":"object","properties":{"status":{"type":"string","enum":["pass","warn","fail","error","skipped"]},"detail":{"type":"string"}}},"mx":{"type":"object","properties":{"status":{"type":"string","enum":["pass","warn","fail","error","skipped"]},"detail":{"type":"string"}}},"disposable":{"type":"object","properties":{"status":{"type":"string","enum":["pass","warn","fail","error","skipped"]},"detail":{"type":"string"}}},"free_provider":{"type":"object","properties":{"status":{"type":"string","enum":["pass","warn","fail","error","skipped"]},"detail":{"type":"string"}}},"role_based":{"type":"object","properties":{"status":{"type":"string","enum":["pass","warn","fail","error","skipped"]},"detail":{"type":"string"}}}}}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","enum":["unauthorized"]},"hint":{"type":"string"}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","enum":["quota_exceeded"]},"tier":{"type":"string"},"scope":{"type":"string","enum":["key","ip"]},"limit":{"type":"integer"},"resets_at":{"type":"string","format":"date-time"},"hint":{"type":"string"}}}}}}}}}},"servers":[{"url":"https://validmail.dev"}],"externalDocs":{"description":"API landing page","url":"https://validmail.dev"}}