{"components":{"schemas":{"ValidationResult":{"properties":{"did_you_mean":{"example":null,"nullable":true,"type":"string"},"email":{"example":"contact@github.com","type":"string"},"format_valid":{"example":true,"type":"boolean"},"free_email":{"example":false,"type":"boolean"},"is_free_provider":{"example":false,"type":"boolean"},"is_valid":{"example":true,"type":"boolean"},"mx_found":{"example":true,"type":"boolean"},"smtp_check":{"example":false,"type":"boolean"},"smtp_status":{"example":null,"nullable":true,"type":"string"},"status":{"enum":["valid","valid_domain","risky","invalid","unknown"],"example":"valid_domain","type":"string"},"sub_status":{"description":"Detailed classification: domain_accepts_email, disposable_email, role_based, invalid_syntax, domain_not_accepting_email, mailbox_exists","example":"role_based","nullable":true,"type":"string"},"suggested_email":{"example":null,"nullable":true,"type":"string"},"verification_time":{"example":0.01,"type":"number"},"verification_time_ms":{"example":14,"type":"integer"}},"type":"object"}},"securitySchemes":{"ApiKeyHeader":{"description":"Your NoBounce API Key (e.g. nb-xxxx...) or RapidAPI key","in":"header","name":"X-API-Key","type":"apiKey"},"ApiKeyQuery":{"description":"Your NoBounce API Key passed as a query parameter","in":"query","name":"api_key","type":"apiKey"}}},"info":{"contact":{"email":"notprathap@gmail.com","name":"NoBounce API Support","url":"https://nobounceapi.com"},"description":"Fast, developer-friendly real-time Email Validation & Bulk CSV Verification API. Validates RFC 5322 syntax, DNS & MX records, 150+ disposable/temp-mail providers, role-based addresses (admin@, support@, billing@), free webmail providers, and domain typo suggestions (e.g., gmial.com -> gmail.com) in ~15ms.","termsOfService":"https://nobounceapi.com/terms","title":"NoBounce Email Validation & Bulk CSV Verification API","version":"1.2.0"},"openapi":"3.0.3","paths":{"/api/validate":{"get":{"description":"Validates syntax, DNS MX records, disposable email providers, role-based accounts, free email providers, and domain typos in ~15ms.","operationId":"validateEmailGet","parameters":[{"description":"Email address to validate","in":"query","name":"email","required":true,"schema":{"example":"support@google.com","type":"string"}},{"description":"Optional deep SMTP handshake check","in":"query","name":"smtp_check","required":false,"schema":{"default":false,"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationResult"}}},"description":"Validation result"},"401":{"description":"Missing or invalid API key"},"403":{"description":"Monthly quota exceeded"}},"summary":"Validate a single email address (GET)"},"post":{"description":"Validates a single email passed via JSON body or form data.","operationId":"validateEmailPost","requestBody":{"content":{"application/json":{"schema":{"properties":{"email":{"example":"user@gmial.com","type":"string"},"smtp_check":{"default":false,"type":"boolean"}},"required":["email"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationResult"}}},"description":"Validation result"}},"summary":"Validate a single email address (POST)"}},"/api/validate-bulk":{"post":{"description":"Validates up to 5,000 emails per batch with concurrent DNS MX caching. Accepts either a JSON array of emails or a multipart CSV/TXT file upload, and returns summary KPIs, individual results, and an enriched CSV.","operationId":"validateBulkEmails","parameters":[{"description":"Set to 'csv' to download the enriched CSV file directly","in":"query","name":"format","required":false,"schema":{"default":"json","enum":["json","csv"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"emails":{"example":["support@google.com","user@gmial.com","temp@mailinator.com"],"items":{"type":"string"},"type":"array"},"format":{"default":"json","enum":["json","csv"],"type":"string"}},"required":["emails"],"type":"object"}},"multipart/form-data":{"schema":{"properties":{"file":{"description":"CSV or TXT file containing email addresses","format":"binary","type":"string"}},"type":"object"}}},"required":true},"responses":{"200":{"description":"Bulk validation summary, results array, and enriched CSV output"}},"summary":"Validate bulk email list via JSON array or CSV file upload"}},"/health":{"get":{"operationId":"healthCheck","responses":{"200":{"description":"Service is healthy"}},"security":[],"summary":"Service health check"}}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"servers":[{"description":"Production Server","url":"https://nobounceapi.com"}]}