{"openapi":"3.1.0","info":{"title":"Email Validation API","version":"1.0.0","description":"Verify email addresses without sending anything: RFC syntax validation, live MX-record lookup, disposable/throwaway detection (5,500+ domain blocklist), role-account and free-provider flags, \"did you mean\" typo suggestion, and a 0–100 deliverability score.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/email-api","description":"oanor gateway"}],"tags":[{"name":"Validation"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/disposable":{"get":{"operationId":"get_v1_disposable","tags":["Validation"],"summary":"Check if a domain is disposable/free","description":"","parameters":[{"name":"domain","in":"query","required":true,"description":"Domain (or pass email=)","schema":{"type":"string"},"example":"mailinator.com"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"domain":"mailinator.com","is_free":false,"is_disposable":true},"meta":{"timestamp":"2026-05-29T22:12:04.791Z","request_id":"a2c2a696-f281-4db0-bab3-98a8db03a738"},"status":"ok","message":"Domain checked successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/verify":{"get":{"operationId":"get_v1_verify","tags":["Validation"],"summary":"Verify an email address","description":"","parameters":[{"name":"email","in":"query","required":true,"description":"Email address to verify","schema":{"type":"string"},"example":"jane.doe@gmail.com"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"email":"jane.doe@gmail.com","score":100,"domain":"gmail.com","reason":"deliverable","status":"deliverable","is_free":true,"is_role":false,"mx_found":true,"local_part":"jane.doe","mx_records":[{"exchange":"gmail-smtp-in.l.google.com","priority":5},{"exchange":"alt1.gmail-smtp-in.l.google.com","priority":10},{"exchange":"alt2.gmail-smtp-in.l.google.com","priority":20},{"exchange":"alt3.gmail-smtp-in.l.google.com","priority":30},{"exchange":"alt4.gmail-smtp-in.l.google.com","priority":40}],"normalized":"jane.doe@gmail.com","valid_syntax":true,"is_disposable":false},"meta":{"timestamp":"2026-05-29T22:12:04.866Z","request_id":"b92c5dc9-56eb-48b1-9a53-eac4770d5523"},"status":"ok","message":"Email verified successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":1000,"rps_limit":2,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":1500,"monthly_call_quota":25000,"rps_limit":10,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":4900,"monthly_call_quota":150000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":12900,"monthly_call_quota":600000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/email-api"}