NOTICE: All information contained herein is, and remains
the property of TechnoCore Automate.
Updated : 2026-03-16
ObjServiceZeroBounce validates email addresses via the ZeroBounce
API. Returns deliverability status (valid, invalid, catch-all,
abuse, etc.) and stores results using the bloom_table_data_structure
pattern for downstream workflow consumption.
| Endpoint | Description |
|---|---|
/v2/validate |
Single email validation |
/v2/getcredits |
Check remaining API credits |
Free tier: 100 validations/month. Paid plans available.
base:
zerobounce:
api_key: "your_api_key_here"
API key is never stored in source code — always read from
config.yaml via get_ini_value().
The service searches for an email address in this order:
context['email'] — explicit in workflow contextself._calc_email — from a calculation workflow stepself._form_email — from a form submissionself._email — generic email attributeself.Param1 — if it contains @self.Guid — if it contains @| Field | Description |
|---|---|
status |
valid, invalid, catch-all, unknown, spamtrap, abuse, do_not_mail |
sub_status |
Detailed reason (e.g. mailbox_not_found, mailbox_quota_exceeded) |
domain_age_days |
Age of the email domain |
free_email |
Whether it's a free provider (gmail, yahoo) |
mx_found |
Whether MX records exist |
smtp_provider |
SMTP provider name |
Results are stored via bloom_table_data_structure() into
bloom_zerobounce_results — the bloom pattern auto-creates
columns from the API response fields.
| Command | Context Keys | Result Keys |
|---|---|---|
validate |
email (or auto-detected) |
_zerobounce_status, _zerobounce_email, _zerobounce_result |
# Validate a single email
python ObjServiceZeroBounce.py validate "user@example.com"
# Check remaining API credits
python ObjServiceZeroBounce.py credits
from ObjServiceZeroBounce import ObjServiceApi
svc = ObjServiceApi()
result = svc.validate_email("user@example.com")
print(f"Status: {result['status']}")
Updated : 2026-03-16
cythonize -3 -a -i ObjServiceZeroBounce.py
Compiling /home/axion/projects/axion/factory.service/package.core/ObjServiceZeroBounce.py because it changed..[1/1] Cythonizing /home/axion/projects/axion/factory.service/package.core/ObjServiceZeroBounce.py
Updated : 2026-03-16