{"openapi":"3.1.0","info":{"title":"G2V Email Verifier API","version":"1.0.0","description":"Verify single addresses and queued bulk lists. Free accounts include 50 verifications per UTC calendar month."},"servers":[{"url":"https://emailverifier.g2v.org/api"}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"G2V API key"}},"schemas":{"Verification":{"type":"object","properties":{"email":{"type":"string","format":"email"},"status":{"type":"string","enum":["valid","invalid","catch_all","greylisted","unknown"]},"verdict":{"type":"string","enum":["safe","risky","undeliverable","unknown"]},"safe_to_send":{"type":"boolean"},"disposable":{"type":"boolean"},"role_based":{"type":"boolean"},"free_provider":{"type":"boolean"},"catch_all":{"type":"boolean"},"greylisted":{"type":"boolean"},"diagnosis":{"type":"string"},"checked_at":{"type":"string","format":"date-time"}}}}},"paths":{"/":{"get":{"summary":"Service metadata","responses":{"200":{"description":"Service metadata"}}},"post":{"summary":"Verify one email address","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["email"],"properties":{"email":{"type":"string","example":"hello@example.com"}}}}}},"responses":{"200":{"description":"Verification result"},"401":{"description":"Invalid API key"},"429":{"description":"Quota or rate limit reached"}}}},"/usage":{"get":{"summary":"Get monthly usage","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Current UTC-month usage"}}}},"/bulk":{"post":{"summary":"Create a bulk verification job","description":"Submit up to 50 unique addresses as JSON or upload a CSV/TXT file.","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["emails"],"properties":{"emails":{"type":"array","maxItems":50,"items":{"type":"string"}},"filename":{"type":"string"}}}},"multipart/form-data":{"schema":{"type":"object","required":["file"],"properties":{"file":{"type":"string","format":"binary"}}}}}},"responses":{"202":{"description":"Job queued"}}}},"/bulk/{job_id}":{"get":{"summary":"Get a bulk job and results","security":[{"bearerAuth":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Job status and result rows"}}}},"/bulk/{job_id}/download":{"get":{"summary":"Download bulk results as CSV","security":[{"bearerAuth":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"UTF-8 CSV file"}}}}}}