ClearBounce Email Verification

{'type': 'object', 'required': ['jobId'], 'properties': {'jobId': {'type': 'string', 'description': 'The jobId returned by verify_bulk'}}}

{'type': 'object', 'required': ['jobId', 'status', 'progress'], 'properties': {'jobId': {'type': 'string'}, 'status': {'type': 'string', 'description': 'pending, processing, completed or failed'}, 'progress': {'type': 'number', 'description': 'Percent complete, 0-100'}, 'resultsUrl': {'type': 'string', 'description': 'Dashboard page where the full result file can be downloaded'}, 'riskyCount': {'type': 'number'}, 'totalEmails': {'type': 'number'}, 'unknownCount': {'type': 'number'}, 'catchAllCount': {'type': 'number'}, 'processedEmails': {'type': 'number'}, 'deliverableCount': {'type': 'number'}, 'undeliverableCount': {'type': 'number'}}}

{'type': 'object', 'properties': {}}

{'type': 'object', 'required': ['credits'], 'properties': {'notice': {'type': 'string', 'description': 'Present only when the balance is low or empty'}, 'credits': {'type': 'number', 'description': 'Remaining verification credits on the account'}, 'success': {'type': 'boolean'}, 'purchaseUrl': {'type': 'string', 'description': 'Where the user can buy more credits'}}}

{'type': 'object', 'required': ['name', 'domain'], 'properties': {'name': {'type': 'string', 'description': 'Full name of the person, e.g. "Jane Porter"'}, 'domain': {'type': 'string', 'description': 'Company domain, e.g. "northwindtraders.com"'}}}

{'type': 'object', 'required': ['status', 'candidates', 'total_candidates'], 'properties': {'note': {'type': 'string', 'description': 'Guidance on verification cost and how to proceed'}, 'status': {'type': 'string', 'description': 'found_published when the address came from a published source, otherwise pattern_guesses'}, 'best_match': {'type': ['string', 'null'], 'description': 'Highest-confidence candidate address'}, 'candidates': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Candidate addresses, highest confidence first'}, 'confidence': {'type': ['number', 'null'], 'description': 'Confidence of the best match, 0-100'}, 'seen_at_company': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Addresses already published at this domain'}, 'total_candidates': {'type': 'number'}, 'detected_company_pattern': {'type': ['string', 'null'], 'description': 'Address pattern used at this company, when known'}}}

{'type': 'object', 'required': ['emails'], 'properties': {'emails': {'type': 'array', 'items': {'type': 'string'}, 'description': 'The email addresses to verify (2 to 10,000 items)'}}}

{'type': 'object', 'required': ['jobId', 'uniqueEmails'], 'properties': {'note': {'type': 'string'}, 'jobId': {'type': 'string', 'description': 'Use this with check_bulk_status'}, 'uniqueEmails': {'type': 'number', 'description': 'Addresses queued after duplicate removal — credits charged for these'}, 'estimatedSeconds': {'type': 'number', 'description': 'Rough time until the job completes'}, 'duplicatesRemoved': {'type': 'number'}}}

{'type': 'object', 'required': ['email'], 'properties': {'email': {'type': 'string', 'description': 'The email address to verify, e.g. jane@example.com'}}}

{'type': 'object', 'required': ['email', 'status', 'score', 'isDeliverable'], 'properties': {'email': {'type': 'string', 'description': 'The address that was checked'}, 'score': {'type': 'number', 'description': 'Quality score from 0 to 100'}, 'checks': {'type': 'object', 'description': 'Detailed checks: syntax, MX, SMTP, disposable, role, catch-all, typo, risk'}, 'notice': {'type': 'string', 'description': 'Present only when the balance is low or empty: tells the user where to buy more credits'}, 'status': {'type': 'string', 'description': 'deliverable, undeliverable, risky or unknown'}, 'subStatus': {'type': 'string', 'description': 'Reason code behind the status'}, 'isDeliverable': {'type': 'boolean'}, 'creditsRemaining': {'type': 'number', 'description': 'Credits left on the account after this check'}}}